W MongoDB $dayOfMonth
operator potoku agregacji zwraca dzień miesiąca dla daty jako liczbę między 1
i 31
.
Opcjonalnie możesz określić strefę czasową, która będzie używana dla wyniku.
$dayOfMonth
operator akceptuje datę (jako Date, Timestamp lub ObjectId) lub dokument określający datę i strefę czasową do użycia.
Przykład
Załóżmy, że mamy kolekcję o nazwie pets
z następującym dokumentem:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "name" : "Fetch", "born" : ISODate("2020-12-31T23:30:15.123Z") }
Możemy uruchomić następujący kod, aby wyodrębnić dzień miesiąca z born
pole w tym dokumencie.
db.pets.aggregate(
[
{
$project:
{
_id: 0,
birthDayOfMonth: { $dayOfMonth: "$born" }
}
}
]
)
Wynik:
{ "birthDayOfMonth" : 31 }
Tutaj użyłem birthDayOfMonth
jako nazwę pola do zwrócenia, ale może to być cokolwiek (na przykład dayOfMonth
, day
itp.).
_id
pole jest domyślnie zwracane podczas korzystania z projekcji w MongoDB, ale w tym przykładzie jawnie ukryłem _id
pole przy użyciu _id: 0
.
Określ strefę czasową
Możesz określić strefę czasową, która ma być używana dla danych wyjściowych $dayOfMonth
operatora.
Gdy to zrobisz, argument zostanie przekazany do $dayOfMonth
musi mieć następującą formę:
{ date: <dateExpression>, timezone: <tzExpression> }
Gdzie <dateExpression>
to data do użycia, a <tzExpression>
to strefa czasowa do użycia.
Strefę czasową można określić za pomocą identyfikatora strefy czasowej Olson (np. "Europe/London"
, "GMT"
) lub przesunięcie UTC (np. "+02:30"
, "-1030"
).
Identyfikator strefy czasowej Olsona
Oto przykład, który wyświetla dzień w dwóch różnych strefach czasowych, z których każda używa identyfikatorów stref czasowych Olson:
db.pets.aggregate(
[
{
$project: {
_id: 0,
honolulu: {
$dayOfMonth: { date: "$born", timezone: "Pacific/Honolulu" }
},
auckland: {
$dayOfMonth: { date: "$born", timezone: "Pacific/Auckland" }
}
}
}
]
)
Wynik:
{ "honolulu" : 31, "auckland" : 1 }
Przesunięcie UTC
Oto ten sam przykład, ale tym razem używamy przesunięcia UTC.
db.pets.aggregate(
[
{
$project: {
_id: 0,
"utcOffset-1000": {
$dayOfMonth: { date: "$born", timezone: "-1000" }
},
"utcOffset+1200": {
$dayOfMonth: { date: "$born", timezone: "+1200" }
}
}
}
]
)
Wynik:
{ "utcOffset-1000" : 31, "utcOffset+1200" : 1 }
Zwróć dzień miesiąca z ObjectId
Możesz użyć $dayOfMonth
aby zwrócić część dnia z ObjectId.
Wartości ObjectId to 12-bajtowe wartości szesnastkowe, które składają się z:
- 4-bajtowa wartość znacznika czasu, reprezentująca utworzenie ObjectId, mierzona w sekundach od epoki Uniksa.
- 5 bajtów to wartość losowa
- Licznik przyrostowy o 3 bajty, zainicjowany do wartości losowej.
Podsumowując, nasz dokument wygląda tak:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "name" : "Fetch", "born" : ISODate("2020-12-31T23:30:15.123Z") }
Ten dokument zawiera ObjectId. Dlatego możemy użyć $dayOfMonth
aby zwrócić dzień miesiąca, w którym nasz dokument został utworzony (a dokładniej, kiedy _id
wartość ObjectId pola została utworzona).
Przykład:
db.pets.aggregate(
[
{
$project:
{
"timeStamp": { $toDate: "$_id"},
"dayOfMonth": { $dayOfMonth: "$_id" }
}
}
]
).pretty()
Wynik:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "timeStamp" : ISODate("2021-01-19T01:11:35Z"), "dayOfMonth" : 19 }
Widzimy, że dokument powstał 19 dnia miesiąca.
W tym przypadku użyłem również $toDate
operator potoku agregacji, aby zwrócić część znacznika czasu ObjectId.