In MongoDB ist die Datei $dateToParts Der Aggregations-Pipeline-Operator gibt die Datumsteile eines bestimmten Datums zurück.
Genauer gesagt gibt es ein Dokument zurück, das die Bestandteile eines bestimmten BSON-Datumswerts als einzelne Eigenschaften enthält.
Die von $dateToParts zurückgegebenen Datumsteile sind year , month , day , hour , minute , second und millisecond .
Bei Verwendung von $dateToParts -Operator können Sie optional eine Zeitzone angeben, die für das Ergebnis verwendet werden soll.
Die $dateToParts -Operator akzeptiert entweder ein Datum (entweder als Date, Timestamp oder ObjectId) oder ein Dokument, das das zu verwendende Datum und die zu verwendende Zeitzone angibt.
Beispiel
Angenommen, wir haben eine Sammlung namens pets mit folgendem Dokument:
{
"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
"name" : "Fetch",
"born" : ISODate("2020-12-31T23:30:15.123Z")
}
Wir können den folgenden Code ausführen, um die verschiedenen Datumsteile von born zurückzugeben Feld in diesem Dokument.
db.pets.aggregate(
[
{
$project:
{
_id: 0,
dateParts: { $dateToParts: { date: "$born" } }
}
}
]
).pretty()Ergebnis:
{
"dateParts" : {
"year" : 2020,
"month" : 12,
"day" : 31,
"hour" : 23,
"minute" : 30,
"second" : 15,
"millisecond" : 123
}
} Wir können sehen, dass jeder Datumsteil in einem eigenen Feld zurückgegeben wird.
Hier habe ich dateParts verwendet als zurückzugebender Feldname, aber das hätte alles sein können (wie theDate etc).
Die _id Das Feld wird standardmäßig zurückgegeben, wenn Projektionen in MongoDB verwendet werden, aber in diesem Beispiel habe ich die _id explizit ausgeblendet Feld mit _id: 0 .
Geben Sie eine Zeitzone an
Sie können eine Zeitzone angeben, die für die Ausgabe von $dateToParts verwendet werden soll Betreiber.
Wenn Sie dies tun, wird das Argument an $dateToParts übergeben muss folgende Form haben:
{ date: <dateExpression>, timezone: <tzExpression> }
Wobei <dateExpression> ist das zu verwendende Datum und <tzExpression> ist die zu verwendende Zeitzone.
Die Zeitzone kann entweder mit der Olson-Zeitzonenkennung (z. B. "Europe/London" , "GMT" ) oder den UTC-Offset (z. B. "+02:30"). , "-1030" ).
Olson-Zeitzonenkennung
Hier ist ein Beispiel, das die Datumsteile in zwei verschiedenen Zeitzonen ausgibt, die jeweils die Olson-Zeitzonen-IDs verwenden:
db.pets.aggregate(
[
{
$project: {
_id: 0,
honolulu: {
$dateToParts: { date: "$born", timezone: "Pacific/Honolulu" }
},
auckland: {
$dateToParts: { date: "$born", timezone: "Pacific/Auckland" }
}
}
}
]
).pretty()Ergebnis:
{
"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 diesem Fall rückt das Datum auf das nächste Jahr/den nächsten Monat/die nächste Woche/den nächsten Tag/die nächste Stunde vor, wenn Pacific/Auckland verwendet wird Zeitzone.
UTC-Offset
Hier ist das gleiche Beispiel, außer dass wir diesmal den UTC-Offset verwenden.
db.pets.aggregate(
[
{
$project: {
_id: 0,
"utcOffset-1000": {
$dateToParts: { date: "$born", timezone: "-1000" }
},
"utcOffset+1200": {
$dateToParts: { date: "$born", timezone: "+1200" }
}
}
}
]
).pretty()Ergebnis:
{
"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
}
} Teile des ISO-Wochendatums
Sie können iso8601: true verwenden , um das Ausgabedokument so zu ändern, dass ISO-Wochendatumsfelder verwendet werden. Dies basiert das Datum auf dem ISO 8601-Standard.
Angenommen, wir haben eine Sammlung namens cats mit folgendem Dokument:
{
"_id" : ObjectId("6008c9a5c8eb4369cf6ad9cc"),
"name" : "Scratch",
"born" : ISODate("2021-01-03T23:30:15.123Z")
}
Wir können den folgenden Code ausführen, um die ISO-Datumsfelder aus born zu extrahieren Feld in diesem Dokument.
Hier ist ein Beispiel zur Veranschaulichung:
db.pets.aggregate(
[
{
$project: {
_id: 0,
dateParts: {
$dateToParts: {
date: "$born"
}
},
datePartsISO: {
$dateToParts: {
date: "$born",
iso8601: true
}
}
}
}
]
).pretty()Ergebnis:
{
"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
}
} Das erste Ausgabedokument verwendet die normale Datumsausgabe. Das zweite Dokument verwendet die ISO-Wochendatumsfelder und -werte.
Gib die Datumsteile von einer ObjectId zurück
Sie können $dateToParts verwenden um die Datumsteile von einer ObjectId zurückzugeben.
ObjectId-Werte sind 12-Byte-Hexadezimalwerte, die aus Folgendem bestehen:
- Ein 4-Byte-Zeitstempelwert, der die Erstellung der ObjectId darstellt, gemessen in Sekunden seit der Unix-Epoche.
- Ein 5 Byte ist ein Zufallswert
- Ein inkrementierender 3-Byte-Zähler, initialisiert auf einen zufälligen Wert.
Zusammenfassend sieht unser Dokument folgendermaßen aus:
{
"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
"name" : "Fetch",
"born" : ISODate("2020-12-31T23:30:15.123Z")
}
Dieses Dokument enthält eine ObjectId. Wir können daher $dateToParts verwenden um die Datumsteile zurückzugeben, basierend auf dem Datum, an dem unser Dokument erstellt wurde (oder genauer gesagt, wann die _id der ObjectId-Wert des Felds wurde erstellt).
Beispiel:
db.pets.aggregate(
[
{
$project:
{
"timeStamp": { $toDate: "$_id"},
"dateParts": { $dateToParts: { date: "$_id" } }
}
}
]
).pretty()Ergebnis:
{
"_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 diesem Fall habe ich auch den $toDate verwendet Aggregations-Pipeline-Operator, um den Zeitstempelteil der ObjectId zurückzugeben.
