I MongoDB, $second
aggregeringspipeline-operatören returnerar den andra delen av ett datum som ett tal mellan 0
och 59
. Värdet kan också vara 60
att ta hänsyn till skottsekunder när det är tillämpligt.
Du kan valfritt ange en tidszon som ska användas för resultatet.
$second
operatören accepterar antingen ett datum (som antingen ett datum, en tidsstämpel eller ett objekt-ID), eller ett dokument som anger datum och tidszon som ska användas.
Exempel
Anta att vi har en samling som heter pets
med följande dokument:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "name" : "Fetch", "born" : ISODate("2020-12-31T23:30:15.123Z") }
Vi kan köra följande kod för att extrahera den andra delen från born
fältet i det dokumentet.
db.pets.aggregate(
[
{
$project:
{
_id: 0,
birthSecond: { $second: "$born" }
}
}
]
)
Resultat:
{ "birthSecond" : 15 }
Här använde jag birthSecond
som fältnamnet att returnera, men detta kan ha varit vad som helst (som secondsAtBirth
, seconds
, etc).
_id
fältet returneras som standard när man använder projektioner i MongoDB, men i det här exemplet gömde jag uttryckligen _id
fält med _id: 0
.
Ange en tidszon
Du kan ange en tidszon som ska användas för utmatningen av $second
operatör.
När du gör detta skickades argumentet till $second
måste vara av följande form:
{ date: <dateExpression>, timezone: <tzExpression> }
Där <dateExpression>
är datumet att använda och <tzExpression>
är tidszonen som ska användas.
Tidszonen kan specificeras med antingen Olsons tidszonsidentifierare (t.ex. "Europe/London"
, "GMT"
) eller UTC-offset (t.ex. "+02:30"
, "-1030"
).
Olsons tidszonsidentifierare
Här är ett exempel som matar ut sekunderna i två olika tidszoner, var och en med hjälp av Olsons tidszons-ID:
db.pets.aggregate(
[
{
$project: {
_id: 0,
kabul: {
$second: { date: "$born", timezone: "Asia/Kabul" }
},
brisbane: {
$second: { date: "$born", timezone: "Australia/Brisbane" }
}
}
}
]
)
Resultat:
{ "kabul" : 15, "brisbane" : 15 }
Eftersom tidszonsändringen inte påverkar sekunddelen är resultatet detsamma.
UTC-offset
I det här exemplet använder vi UTC-offset.
db.pets.aggregate(
[
{
$project: {
_id: 0,
"utcOffset+04:30": {
$second: { date: "$born", timezone: "+04:30" }
},
"utcOffset+05:45": {
$second: { date: "$born", timezone: "+05:45" }
}
}
}
]
)
Resultat:
{ "utcOffset+04:30" : 15, "utcOffset+05:45" : 15 }
Returnera sekunderna från ett objekt-ID
Du kan använda $second
för att returnera sekundersdelen från ett ObjectId.
ObjectId-värden är hexadecimala värden på 12 byte som består av:
- Ett tidsstämpelvärde på 4 byte, som representerar objekt-ID:ts skapelse, mätt i sekunder sedan Unix-epoken.
- En 5 byte är ett slumpmässigt värde
- En 3-byte inkrementerande räknare, initierad till ett slumpmässigt värde.
För att sammanfatta ser vårt dokument ut så här:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "name" : "Fetch", "born" : ISODate("2020-12-31T23:30:15.123Z") }
Detta dokument innehåller ett ObjectId. Vi kan därför använda $second
för att returnera den andra som vårt dokument skapades (eller mer specifikt, när _id
fältets ObjectId-värde skapades).
Exempel:
db.pets.aggregate(
[
{
$project:
{
"timeStamp": { $toDate: "$_id"},
"second": { $second: "$_id" }
}
}
]
).pretty()
Resultat:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "timeStamp" : ISODate("2021-01-19T01:11:35Z"), "second" : 35 }
Vi kan se att dokumentet skapades den 35:e sekunden (av den 11:e minuten av den första timmen på dagen).
I det här fallet använde jag också $toDate
aggregeringspipeline-operatör för att returnera tidsstämpeldelen av ObjectId.