W MongoDB $minute
Operator potoku agregacji zwraca minutową część daty jako liczbę między 0
i 59
.
Opcjonalnie możesz określić strefę czasową, która będzie używana dla wyniku.
$minute
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ć część minutową z born
pole w tym dokumencie.
db.pets.aggregate(
[
{
$project:
{
_id: 0,
birthMinute: { $minute: "$born" }
}
}
]
)
Wynik:
{ "birthMinute" : 30 }
Tutaj użyłem birthMinute
jako nazwę pola do zwrócenia, ale może to być cokolwiek (na przykład minutesAtBirth
, minutes
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 będzie używana dla wyjścia $minute
operatora.
Gdy to zrobisz, argument zostanie przekazany do $minute
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 minutę 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,
kabul: {
$minute: { date: "$born", timezone: "Asia/Kabul" }
},
katmandu: {
$minute: { date: "$born", timezone: "Asia/Katmandu" }
}
}
}
]
)
Wynik:
{ "kabul" : 0, "katmandu" : 15 }
Przesunięcie UTC
W tym przykładzie używamy przesunięcia UTC.
db.pets.aggregate(
[
{
$project: {
_id: 0,
"utcOffset+04:30": {
$minute: { date: "$born", timezone: "+04:30" }
},
"utcOffset+05:45": {
$minute: { date: "$born", timezone: "+05:45" }
}
}
}
]
)
Wynik:
{ "utcOffset+04:30" : 0, "utcOffset+05:45" : 15 }
Zwróć minuty z ObjectId
Możesz użyć $minute
aby zwrócić część minutową 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. Możemy zatem użyć $minute
aby zwrócić minutę utworzenia naszego dokumentu (a dokładniej, gdy _id
wartość ObjectId pola została utworzona).
Przykład:
db.pets.aggregate(
[
{
$project:
{
"timeStamp": { $toDate: "$_id"},
"minute": { $minute: "$_id" }
}
}
]
).pretty()
Wynik:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "timeStamp" : ISODate("2021-01-19T01:11:35Z"), "minute" : 11 }
Widzimy, że dokument powstał w 11 minucie 1 godziny doby.
W tym przypadku użyłem również $toDate
operator potoku agregacji, aby zwrócić część znacznika czasu ObjectId.