V MongoDB, $minute
operátor agregačního kanálu vrátí minutovou část data jako číslo mezi 0
a 59
.
Volitelně můžete zadat časové pásmo, které se použije pro výsledek.
$minute
operátor přijímá buď datum (jako datum, časové razítko nebo ObjectId), nebo dokument, který určuje datum a časové pásmo, které se má použít.
Příklad
Předpokládejme, že máme sbírku nazvanou pets
s následujícím dokumentem:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "name" : "Fetch", "born" : ISODate("2020-12-31T23:30:15.123Z") }
Můžeme spustit následující kód a extrahovat minutovou část z born
pole v tomto dokumentu.
db.pets.aggregate(
[
{
$project:
{
_id: 0,
birthMinute: { $minute: "$born" }
}
}
]
)
Výsledek:
{ "birthMinute" : 30 }
Zde jsem použil birthMinute
jako název pole, které se má vrátit, ale mohlo to být cokoliv (například minutesAtBirth
, minutes
, atd).
_id
pole je vráceno ve výchozím nastavení při použití projekcí v MongoDB, ale v tomto příkladu jsem explicitně skryl _id
pole pomocí _id: 0
.
Zadejte časové pásmo
Můžete zadat časové pásmo, které se použije pro výstup $minute
operátor.
Když to uděláte, argument předá $minute
musí mít následující tvar:
{ date: <dateExpression>, timezone: <tzExpression> }
Kde <dateExpression>
je datum použití a <tzExpression>
je časové pásmo, které se má použít.
Časové pásmo lze zadat pomocí identifikátoru časového pásma Olson (např. "Europe/London"
, "GMT"
) nebo offset UTC (např. "+02:30"
, "-1030"
).
Olsonův identifikátor časového pásma
Zde je příklad, který zobrazuje minutu ve dvou různých časových pásmech, každé s použitím Olsonových ID časových pásem:
db.pets.aggregate(
[
{
$project: {
_id: 0,
kabul: {
$minute: { date: "$born", timezone: "Asia/Kabul" }
},
katmandu: {
$minute: { date: "$born", timezone: "Asia/Katmandu" }
}
}
}
]
)
Výsledek:
{ "kabul" : 0, "katmandu" : 15 }
Posun UTC
V tomto příkladu používáme 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" }
}
}
}
]
)
Výsledek:
{ "utcOffset+04:30" : 0, "utcOffset+05:45" : 15 }
Vrátí minuty z ObjectId
Můžete použít $minute
vrátit minutovou část z ObjectId.
Hodnoty ObjectId jsou 12bajtové hexadecimální hodnoty, které se skládají z:
- Čtyřbajtová hodnota časového razítka představující vytvoření ObjectId, měřená v sekundách od epochy Unixu.
- 5 bajtů je náhodná hodnota
- 3bajtový inkrementační čítač, inicializovaný na náhodnou hodnotu.
Abychom to shrnuli, náš dokument vypadá takto:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "name" : "Fetch", "born" : ISODate("2020-12-31T23:30:15.123Z") }
Tento dokument obsahuje ObjectId. Můžeme tedy použít $minute
vrátit minutu, kdy byl náš dokument vytvořen (nebo konkrétněji, když _id
byla vytvořena hodnota ObjectId pole).
Příklad:
db.pets.aggregate(
[
{
$project:
{
"timeStamp": { $toDate: "$_id"},
"minute": { $minute: "$_id" }
}
}
]
).pretty()
Výsledek:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "timeStamp" : ISODate("2021-01-19T01:11:35Z"), "minute" : 11 }
Vidíme, že dokument byl vytvořen v 11. minutu 1. hodiny dne.
V tomto případě jsem také použil $toDate
operátor agregačního kanálu, aby vrátil část ObjectId s časovým razítkem.