In MongoDB, il $isoDayOfWeek l'operatore della pipeline di aggregazione restituisce il numero del giorno della settimana nel formato ISO 8601, compreso tra 1 (per lunedì) a 7 (per domenica).
Facoltativamente, puoi specificare un fuso orario da utilizzare per il risultato.
Il $isoDayOfWeek operatore accetta una data (come una data, un timestamp o un ObjectId) o un documento che specifica la data e il fuso orario da utilizzare.
Esempio
Supponiamo di avere una collezione chiamata pets con il seguente documento:
{
"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
"name" : "Fetch",
"born" : ISODate("2020-12-31T23:30:15.123Z")
}
Possiamo eseguire il codice seguente per estrarre il giorno ISO della settimana da born campo in quel documento.
db.pets.aggregate(
[
{
$project:
{
_id: 0,
birthIsoDayOfWeek: { $isoDayOfWeek: "$born" }
}
}
]
)Risultato:
{ "birthIsoDayOfWeek" : 4 }
In questo caso otteniamo un risultato di 4, che è un risultato diverso da quello che ottengo usando $dayOfWeek operatore sullo stesso documento.
Qui ho usato birthIsoDayOfWeek come nome del campo da restituire, ma potrebbe essere qualsiasi cosa (come isoDayOfWeek , day , eccetera).
Il _id il campo viene restituito per impostazione predefinita quando si utilizzano le proiezioni in MongoDB, ma in questo esempio ho nascosto esplicitamente _id campo utilizzando _id: 0 .
Specifica un fuso orario
Puoi specificare un fuso orario da utilizzare per l'output di $isoDayOfWeek operatore.
Quando lo fai, l'argomento è passato a $isoDayOfWeek deve essere della seguente forma:
{ date: <dateExpression>, timezone: <tzExpression> }
Dove <dateExpression> è la data da utilizzare e <tzExpression> è il fuso orario da utilizzare.
Il fuso orario può essere specificato utilizzando l'identificatore del fuso orario Olson (ad es. "Europe/London" , "GMT" ) o l'offset UTC (ad es. "+02:30" , "-1030" ).
Identificatore di fuso orario Olson
Ecco un esempio che restituisce il giorno in due diversi fusi orari, ciascuno dei quali utilizza gli ID fuso orario Olson:
db.pets.aggregate(
[
{
$project: {
_id: 0,
honolulu: {
$isoDayOfWeek: { date: "$born", timezone: "Pacific/Honolulu" }
},
auckland: {
$isoDayOfWeek: { date: "$born", timezone: "Pacific/Auckland" }
}
}
}
]
)Risultato:
{ "honolulu" : 4, "auckland" : 5 } Offset UTC
Ecco lo stesso esempio, tranne che questa volta usiamo l'offset UTC.
db.pets.aggregate(
[
{
$project: {
_id: 0,
"utcOffset-1000": {
$isoDayOfWeek: { date: "$born", timezone: "-1000" }
},
"utcOffset+1200": {
$isoDayOfWeek: { date: "$born", timezone: "+1200" }
}
}
}
]
)Risultato:
{ "utcOffset-1000" : 4, "utcOffset+1200" : 5 } Restituisce il giorno della settimana da un ObjectId
Puoi usare $isoDayOfWeek per restituire la parte del giorno della settimana ISO da un ObjectId.
I valori ObjectId sono valori esadecimali a 12 byte costituiti da:
- Un valore di timestamp di 4 byte, che rappresenta la creazione dell'ObjectId, misurato in secondi dall'epoca di Unix.
- Un 5 byte è un valore casuale
- Un contatore incrementale di 3 byte, inizializzato su un valore casuale.
Per ricapitolare, il nostro documento si presenta così:
{
"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
"name" : "Fetch",
"born" : ISODate("2020-12-31T23:30:15.123Z")
}
Questo documento contiene un ObjectId. Possiamo quindi utilizzare $isoDayOfWeek per restituire il giorno ISO della settimana in cui è stato creato il nostro documento (o più precisamente, quando il _id è stato creato il valore ObjectId del campo).
Esempio:
db.pets.aggregate(
[
{
$project:
{
"timeStamp": { $toDate: "$_id"},
"isoDayOfWeek": { $isoDayOfWeek: "$_id" }
}
}
]
).pretty()Risultato:
{
"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
"timeStamp" : ISODate("2021-01-19T01:11:35Z"),
"isoDayOfWeek" : 2
} Possiamo vedere che il documento è stato creato il 2° giorno della settimana utilizzando il formato ISO 8601.
In questo caso, ho utilizzato anche $toDate operatore della pipeline di aggregazione per restituire la parte timestamp di ObjectId.
