MongoDB zapewnia szeroki wybór operatorów potoku agregacji do pracy z datami, w tym operatorów, które wyodrębniają pewne części dat, takie jak rok, miesiąc, dzień, godziny, minuty itp.
Istnieje również kilka metod MongoDB, które umożliwiają iterację przez kursor i zastosowanie funkcji JavaScript. Dlatego możesz użyć JavaScript do wyodrębnienia wartości dat i części dat itp. z pola zgodnie z wymaganiami.
W tym artykule przedstawiono 5 sposobów na zwrócenie części godzinowej z obiektu Date w MongoDB.
Przykładowe dane
Załóżmy, że mamy kolekcję o nazwie cats
z następującymi dokumentami:
{ "_id" : 1, "name" : "Scratch", "born" : ISODate("2021-01-03T23:30:15.123Z") } { "_id" : 2, "name" : "Meow", "born" : ISODate("2019-12-08T04:00:12Z") } { "_id" : 3, "name" : "Fluffy", "born" : ISODate("2020-09-24T10:30:00Z") }
Poniższe przykłady pokazują różne opcje zwracania części godzinowej z born
pola tych dokumentów.
$hour
Operator
$hour
operator jest specjalnie zaprojektowany do zwracania dokumentu z częścią godzinową podanej daty.
Możemy uruchomić następujący kod, aby zwrócić część godzinową z born
w powyższym dokumencie.
db.cats.aggregate(
[
{
$project:
{
_id: 0,
birthHour: { $hour: "$born" }
}
}
]
)
Wynik:
{ "birthHour" : 23 } { "birthHour" : 4 } { "birthHour" : 10 }
Możesz także określić strefę czasową, używając $hour
operator.
Zobacz MongoDB $hour
aby uzyskać więcej informacji i przykładów.
$dateToString
Operator
$dateToString
operator konwertuje obiekt daty na ciąg znaków zgodnie z formatem określonym przez użytkownika. Użytkownik może zatem określić, że w razie potrzeby zwracana jest tylko część godzinowa.
Dla każdej części daty istnieją specyfikatory formatu. %H
specyfikator formatu zwraca godzinę.
Przykład:
db.cats.aggregate(
[
{
$project: {
_id: 0,
birthHour: { $dateToString: { format: "%H", date: "$born" } }
}
}
]
)
Wynik:
{ "birthHour" : "23" } { "birthHour" : "04" } { "birthHour" : "10" }
Mogliśmy podać więcej specyfikatorów formatu, aby uwzględnić w wyniku części dat, ale ponieważ w tym artykule interesuje nas tylko wyodrębnienie godziny, użyliśmy tylko jednego specyfikatora formatu.
Zobacz MongoDB $dateToString
aby uzyskać więcej informacji i przykładów.
$dateToParts
Operator
$dateToParts
Operator zwraca dokument, który zawiera części składowe danej wartości daty BSON jako indywidualne właściwości. Zwracane właściwości to year
, month
, day
, hour
, minute
, second
i millisecond
.
Dlatego moglibyśmy użyć $dateToParts
w jednym etapie potoku, a następnie dodaj kolejny etap potoku, który wyodrębni hour
część.
Oto, co $dateToParts
zwraca po nasze trzy dokumenty:
db.cats.aggregate(
[
{
$project:
{
_id: 0,
dateParts: { $dateToParts: { date: "$born" } }
}
}
]
).pretty()
Wynik:
{ "dateParts" : { "year" : 2021, "month" : 1, "day" : 3, "hour" : 23, "minute" : 30, "second" : 15, "millisecond" : 123 } } { "dateParts" : { "year" : 2019, "month" : 12, "day" : 8, "hour" : 4, "minute" : 0, "second" : 12, "millisecond" : 0 } } { "dateParts" : { "year" : 2020, "month" : 9, "day" : 24, "hour" : 10, "minute" : 30, "second" : 0, "millisecond" : 0 } }
Ten wynik można następnie przekazać do następnego etapu w potoku, aby wyodrębnić tylko hour
pole.
Oto, co się stanie, jeśli dodamy kolejną projekcję tylko na hour
pole:
db.cats.aggregate(
[
{
$project:
{
_id: 0,
dateParts: { $dateToParts: { date: "$born" } }
}
},
{
$project:
{
birthHour: "$dateParts.hour"
}
}
]
)
Wynik:
{ "birthHour" : 23 } { "birthHour" : 4 } { "birthHour" : 10 }
Chodzi o to, jeśli używasz $dateToParts
w swoim potoku, automatycznie masz dostęp do części godzinowej (i wszystkich innych części) w następnym etapie.
Zobacz MongoDB $dateToParts
aby uzyskać więcej informacji i przykładów.
forEach()
Metoda
Możesz użyć cursor.forEach()
do iteracji przez kursor za pomocą metody JavaScript, takiej jak getHours()
lub getUTCHours()
aby zwrócić tylko wartość godziny.
db.cats.find().forEach(
function(c) {
print(
c.born.getUTCHours()
);
}
);
Wynik:
23 4 10
getUTCHours()
Metoda JavaScript zwraca liczbę całkowitą z przedziału od 0 do 23, reprezentującą godziny w podanej dacie według czasu uniwersalnego.
Możesz również zauważyć, że poprzednie opcje zwracają cały dokument zawierający parę nazwa/wartość, podczas gdy ta opcja zwraca tylko rzeczywistą wartość godziny, a nie cały dokument.
map()
Metoda
cursor.map()
Metoda stosuje funkcję do każdego dokumentu odwiedzanego przez kursor i łączy wartości w tablicę.
Przykład:
db.cats.find().map(
function(c) {
c = c.born.getHours();
return c;
}
);
Wynik:
[ 9, 14, 20 ]
Być może zauważyłeś, że otrzymane godziny różnią się od poprzednich przykładów. To dlatego, że w tym przykładzie użyłem funkcji getHours()
Metoda JavaScript. Ta metoda zwraca swój wynik zgodnie z czasem lokalnym. Równie dobrze mogłem użyć getUTCHours()
.