V MongoDB, $second
operátor agregačního kanálu vrátí druhou část data jako číslo mezi 0
a 59
. Hodnota může být také 60
započítávat přestupné sekundy, kdykoli je to možné.
Volitelně můžete zadat časové pásmo, které se použije pro výsledek.
$second
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 druhou část z born
pole v tomto dokumentu.
db.pets.aggregate(
[
{
$project:
{
_id: 0,
birthSecond: { $second: "$born" }
}
}
]
)
Výsledek:
{ "birthSecond" : 15 }
Zde jsem použil birthSecond
jako název pole, které se má vrátit, ale mohlo to být cokoliv (například secondsAtBirth
, seconds
, 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 určit časové pásmo, které se použije pro výstup $second
operátor.
Když to uděláte, argument předá $second
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 buď 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 sekundy 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: {
$second: { date: "$born", timezone: "Asia/Kabul" }
},
brisbane: {
$second: { date: "$born", timezone: "Australia/Brisbane" }
}
}
}
]
)
Výsledek:
{ "kabul" : 15, "brisbane" : 15 }
Vzhledem k tomu, že změna časového pásma nemá vliv na sekundovou část, výsledek je stejný.
Posun UTC
V tomto příkladu používáme offset UTC.
db.pets.aggregate(
[
{
$project: {
_id: 0,
"utcOffset+04:30": {
$second: { date: "$born", timezone: "+04:30" }
},
"utcOffset+05:45": {
$second: { date: "$born", timezone: "+05:45" }
}
}
}
]
)
Výsledek:
{ "utcOffset+04:30" : 15, "utcOffset+05:45" : 15 }
Vrátí sekundy z ObjectId
Můžete použít $second
vrátíte sekundovou čá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 $second
vrátit sekundu, 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"},
"second": { $second: "$_id" }
}
}
]
).pretty()
Výsledek:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "timeStamp" : ISODate("2021-01-19T01:11:35Z"), "second" : 35 }
Vidíme, že dokument byl vytvořen 35. sekundy (11. minuty 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.