In MongoDB die $hour
Der Aggregations-Pipeline-Operator gibt den Stundenteil eines Datums als Zahl zwischen 0
zurück und 23
.
Sie können optional eine Zeitzone angeben, die für das Ergebnis verwendet werden soll.
Die $hour
-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 den Stundenteil aus born
zu extrahieren Feld in diesem Dokument.
db.pets.aggregate(
[
{
$project:
{
_id: 0,
birthHour: { $hour: "$born" }
}
}
]
)
Ergebnis:
{ "birthHour" : 23 }
Hier habe ich birthHour
verwendet als zurückzugebender Feldname, aber das hätte alles sein können (wie hourOfBirth
, hour
, 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 $hour
verwendet werden soll Betreiber.
Wenn Sie dies tun, wird das Argument an $hour
ü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 Stunde in zwei verschiedenen Zeitzonen ausgibt, die jeweils die Olson-Zeitzonen-IDs verwenden:
db.pets.aggregate(
[
{
$project: {
_id: 0,
honolulu: {
$hour: { date: "$born", timezone: "Pacific/Honolulu" }
},
auckland: {
$hour: { date: "$born", timezone: "Pacific/Auckland" }
}
}
}
]
)
Ergebnis:
{ "honolulu" : 13, "auckland" : 12 }
UTC-Offset
In diesem Beispiel verwenden wir den UTC-Offset.
db.pets.aggregate(
[
{
$project: {
_id: 0,
"utcOffset-1000": {
$hour: { date: "$born", timezone: "-1000" }
},
"utcOffset+1200": {
$hour: { date: "$born", timezone: "+1200" }
}
}
}
]
)
Ergebnis:
{ "utcOffset-1000" : 13, "utcOffset+1200" : 11 }
Gib die Stunde von einer ObjectId zurück
Sie können $hour
verwenden um den Stundenteil 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 $hour
verwenden um die Stunde des Tages zurückzugeben, zu der 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"},
"hour": { $hour: "$_id" }
}
}
]
).pretty()
Ergebnis:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "timeStamp" : ISODate("2021-01-19T01:11:35Z"), "hour" : 1 }
Wir können sehen, dass das Dokument in der 1. Stunde des Tages erstellt wurde.
In diesem Fall habe ich auch den $toDate
verwendet Aggregations-Pipeline-Operator, um den Zeitstempelteil der ObjectId zurückzugeben.