In MongoDB, de $dateToParts aggregatiepijplijnoperator retourneert de datumdelen van een bepaalde datum.
Meer specifiek retourneert het een document dat de samenstellende delen van een bepaalde BSON-datumwaarde als individuele eigenschappen bevat.
De datumdelen geretourneerd door $dateToParts zijn year , month , day , hour , minute , second en millisecond .
Bij gebruik van de $dateToParts operator, kunt u optioneel een tijdzone specificeren die voor het resultaat moet worden gebruikt.
De $dateToParts 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 de verschillende datumdelen van de born . te retourneren veld in dat document.
db.pets.aggregate(
[
{
$project:
{
_id: 0,
dateParts: { $dateToParts: { date: "$born" } }
}
}
]
).pretty()Resultaat:
{
"dateParts" : {
"year" : 2020,
"month" : 12,
"day" : 31,
"hour" : 23,
"minute" : 30,
"second" : 15,
"millisecond" : 123
}
} We kunnen zien dat elk datumgedeelte in zijn eigen veld wordt geretourneerd.
Hier gebruikte ik dateParts als de veldnaam die moet worden geretourneerd, maar dit kan van alles zijn (zoals theDate 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 $dateToParts telefoniste.
Wanneer u dit doet, wordt het argument doorgegeven aan $dateToParts 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 datumdelen in twee verschillende tijdzones uitvoert, elk met behulp van de Olson-tijdzone-ID's:
db.pets.aggregate(
[
{
$project: {
_id: 0,
honolulu: {
$dateToParts: { date: "$born", timezone: "Pacific/Honolulu" }
},
auckland: {
$dateToParts: { date: "$born", timezone: "Pacific/Auckland" }
}
}
}
]
).pretty()Resultaat:
{
"honolulu" : {
"year" : 2020,
"month" : 12,
"day" : 31,
"hour" : 13,
"minute" : 30,
"second" : 15,
"millisecond" : 123
},
"auckland" : {
"year" : 2021,
"month" : 1,
"day" : 1,
"hour" : 12,
"minute" : 30,
"second" : 15,
"millisecond" : 123
}
}
In dit geval gaat de datum vooruit naar het volgende jaar/maand/week/dag/uur bij gebruik van de Pacific/Auckland tijdzone.
UTC-offset
Hier is hetzelfde voorbeeld, behalve dat we deze keer de UTC-offset gebruiken.
db.pets.aggregate(
[
{
$project: {
_id: 0,
"utcOffset-1000": {
$dateToParts: { date: "$born", timezone: "-1000" }
},
"utcOffset+1200": {
$dateToParts: { date: "$born", timezone: "+1200" }
}
}
}
]
).pretty()Resultaat:
{
"utcOffset-1000" : {
"year" : 2020,
"month" : 12,
"day" : 31,
"hour" : 13,
"minute" : 30,
"second" : 15,
"millisecond" : 123
},
"utcOffset+1200" : {
"year" : 2021,
"month" : 1,
"day" : 1,
"hour" : 11,
"minute" : 30,
"second" : 15,
"millisecond" : 123
}
} ISO weekdatum onderdelen
U kunt iso8601: true . gebruiken om het uitvoerdocument te wijzigen om ISO-weekdatumvelden te gebruiken. Hierbij is de datum gebaseerd op de ISO 8601 norm.
Stel dat we een verzameling hebben met de naam cats met het volgende document:
{
"_id" : ObjectId("6008c9a5c8eb4369cf6ad9cc"),
"name" : "Scratch",
"born" : ISODate("2021-01-03T23:30:15.123Z")
}
We kunnen de volgende code uitvoeren om de ISO-datumvelden te extraheren uit de born veld in dat document.
Hier is een voorbeeld om te demonstreren:
db.pets.aggregate(
[
{
$project: {
_id: 0,
dateParts: {
$dateToParts: {
date: "$born"
}
},
datePartsISO: {
$dateToParts: {
date: "$born",
iso8601: true
}
}
}
}
]
).pretty()Resultaat:
{
"dateParts" : {
"year" : 2020,
"month" : 12,
"day" : 31,
"hour" : 23,
"minute" : 30,
"second" : 15,
"millisecond" : 123
},
"datePartsISO" : {
"isoWeekYear" : 2020,
"isoWeek" : 53,
"isoDayOfWeek" : 4,
"hour" : 23,
"minute" : 30,
"second" : 15,
"millisecond" : 123
}
} Het eerste uitvoerdocument gebruikt de normale datumuitvoer. Het tweede document gebruikt de ISO-weekdatumvelden en -waarden.
Retourneer de datumdelen van een ObjectId
U kunt $dateToParts . gebruiken om de datumdelen 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 $dateToParts . gebruiken om de datumdelen te retourneren, gebaseerd op de datum waarop ons document is gemaakt (of meer specifiek, wanneer de _id de ObjectId-waarde van het veld is gemaakt).
Voorbeeld:
db.pets.aggregate(
[
{
$project:
{
"timeStamp": { $toDate: "$_id"},
"dateParts": { $dateToParts: { date: "$_id" } }
}
}
]
).pretty()Resultaat:
{
"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
"timeStamp" : ISODate("2021-01-19T01:11:35Z"),
"dateParts" : {
"year" : 2021,
"month" : 1,
"day" : 19,
"hour" : 1,
"minute" : 11,
"second" : 35,
"millisecond" : 0
}
}
In dit geval heb ik ook de $toDate . gebruikt aggregatiepijplijnoperator om het tijdstempelgedeelte van de ObjectId te retourneren.