In MongoDB, il $minute l'operatore della pipeline di aggregazione restituisce la parte dei minuti di una data come numero compreso tra 0 e 59 .
Puoi facoltativamente specificare un fuso orario da utilizzare per il risultato.
Il $minute 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 la porzione minuscola dal born campo in quel documento.
db.pets.aggregate(
[
{
$project:
{
_id: 0,
birthMinute: { $minute: "$born" }
}
}
]
)Risultato:
{ "birthMinute" : 30 }
Qui ho usato birthMinute come nome del campo da restituire, ma potrebbe essere qualsiasi cosa (come minutesAtBirth , minutes , 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 $minute operatore.
Quando lo fai, l'argomento passa a $minute 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 i minuti in due diversi fusi orari, ciascuno dei quali utilizza gli ID fuso orario Olson:
db.pets.aggregate(
[
{
$project: {
_id: 0,
kabul: {
$minute: { date: "$born", timezone: "Asia/Kabul" }
},
katmandu: {
$minute: { date: "$born", timezone: "Asia/Katmandu" }
}
}
}
]
)Risultato:
{ "kabul" : 0, "katmandu" : 15 } Offset UTC
In questo esempio utilizziamo l'offset UTC.
db.pets.aggregate(
[
{
$project: {
_id: 0,
"utcOffset+04:30": {
$minute: { date: "$born", timezone: "+04:30" }
},
"utcOffset+05:45": {
$minute: { date: "$born", timezone: "+05:45" }
}
}
}
]
)Risultato:
{ "utcOffset+04:30" : 0, "utcOffset+05:45" : 15 } Restituisci i minuti da un ObjectId
Puoi usare $minute per restituire la parte dei minuti 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 $minute per restituire il minuto in cui il nostro documento è stato creato (o più specificamente, quando il _id è stato creato il valore ObjectId del campo).
Esempio:
db.pets.aggregate(
[
{
$project:
{
"timeStamp": { $toDate: "$_id"},
"minute": { $minute: "$_id" }
}
}
]
).pretty()Risultato:
{
"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
"timeStamp" : ISODate("2021-01-19T01:11:35Z"),
"minute" : 11
} Possiamo vedere che il documento è stato creato l'11° minuto della prima ora del giorno.
In questo caso, ho utilizzato anche $toDate operatore della pipeline di aggregazione per restituire la parte timestamp di ObjectId.
