In MongoDB is de $millisecond
aggregatiepijplijnoperator retourneert het millisecondegedeelte van een datum als een geheel getal tussen 0
en 999
.
U kunt optioneel een tijdzone specificeren die voor het resultaat moet worden gebruikt.
De $millisecond
operator accepteert een datum (als een datum, een tijdstempel of een object-ID) of een document dat de te gebruiken datum en tijdzone specificeert.
Voorbeeld
Stel dat we een verzameling hebben met de naam pets
met het volgende document:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "name" : "Fetch", "born" : ISODate("2020-12-31T23:30:15.123Z") }
We kunnen de volgende code uitvoeren om het milliseconde-gedeelte te extraheren uit de born
veld in dat document.
db.pets.aggregate(
[
{
$project:
{
_id: 0,
birthMilliSecond: { $millisecond: "$born" }
}
}
]
)
Resultaat:
{ "birthMilliSecond" : 123 }
Hier gebruikte ik birthMilliSecond
als de veldnaam die moet worden geretourneerd, maar dit kan van alles zijn (zoals milliSecondsAtBirth
, milliSeconds
, enzovoort).
De _id
veld wordt standaard geretourneerd bij het gebruik van projecties in MongoDB, maar in dit voorbeeld heb ik de _id
expliciet verborgen veld met _id: 0
.
Geef een tijdzone op
U kunt een tijdzone specificeren die moet worden gebruikt voor de uitvoer van de $millisecond
telefoniste.
Wanneer u dit doet, wordt het argument doorgegeven aan $millisecond
moet de volgende vorm hebben:
{ date: <dateExpression>, timezone: <tzExpression> }
Waar <dateExpression>
is de te gebruiken datum, en <tzExpression>
is de te gebruiken tijdzone.
De tijdzone kan worden opgegeven met behulp van de Olson-tijdzone-ID (bijv. "Europe/London"
, "GMT"
) of de UTC-offset (bijv. "+02:30"
, "-1030"
).
Olson tijdzone-ID
Hier is een voorbeeld dat de milliseconden in twee verschillende tijdzones uitvoert, elk met behulp van de Olson-tijdzone-ID's:
db.pets.aggregate(
[
{
$project: {
_id: 0,
kabul: {
$millisecond: { date: "$born", timezone: "Asia/Kabul" }
},
brisbane: {
$millisecond: { date: "$born", timezone: "Australia/Brisbane" }
}
}
}
]
)
Resultaat:
{ "kabul" : 123, "brisbane" : 123 }
Aangezien de verandering van de tijdzone geen invloed heeft op het millisecondengedeelte, is het resultaat hetzelfde.
UTC-offset
In dit voorbeeld gebruiken we de UTC-offset.
db.pets.aggregate(
[
{
$project: {
_id: 0,
"utcOffset+04:30": {
$millisecond: { date: "$born", timezone: "+04:30" }
},
"utcOffset+05:45": {
$millisecond: { date: "$born", timezone: "+05:45" }
}
}
}
]
)
Resultaat:
{ "utcOffset+04:30" : 123, "utcOffset+05:45" : 123 }
Retourneer de milliseconden van een ObjectId
U kunt $millisecond
. gebruiken om het millisecondengedeelte van een ObjectId te retourneren.
ObjectId-waarden zijn hexadecimale waarden van 12 bytes die bestaan uit:
- Een tijdstempelwaarde van 4 byte, die de creatie van de ObjectId vertegenwoordigt, gemeten in seconden sinds het Unix-tijdperk.
- Een 5 byte is een willekeurige waarde
- Een oplopende teller van 3 bytes, geïnitialiseerd op een willekeurige waarde.
Samenvattend ziet ons document er als volgt uit:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "name" : "Fetch", "born" : ISODate("2020-12-31T23:30:15.123Z") }
Dit document bevat een ObjectId. We kunnen daarom $millisecond
. gebruiken om het milliseconde-gedeelte van die ObjectId te retourneren.
Zoals eerder vermeld, wordt het tijdzonegedeelte van de ObjectId echter alleen gemeten in seconden sinds het Unix-tijdperk, en daarom bevat het geen millisecondengedeelte.
Voorbeeld:
db.pets.aggregate(
[
{
$project:
{
"timeStamp": { $toDate: "$_id"},
"millisecond": { $millisecond: "$_id" }
}
}
]
).pretty()
Resultaat:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "timeStamp" : ISODate("2021-01-19T01:11:35Z"), "millisecond" : 0 }
We kunnen zien dat de tijdstempel geen millisecondegedeelte bevat en het resultaat is 0
.
In dit geval heb ik ook de $toDate
. gebruikt aggregatiepijplijnoperator om het tijdstempelgedeelte van de ObjectId te retourneren.