W MongoDB $second
operator potoku agregacji zwraca drugą część daty jako liczbę między 0
i 59
. Wartość może również wynosić 60
uwzględniać sekundy przestępne, gdy ma to zastosowanie.
Opcjonalnie możesz określić strefę czasową, która będzie używana dla wyniku.
$second
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ć drugą część z born
pole w tym dokumencie.
db.pets.aggregate(
[
{
$project:
{
_id: 0,
birthSecond: { $second: "$born" }
}
}
]
)
Wynik:
{ "birthSecond" : 15 }
Tutaj użyłem birthSecond
jako nazwę pola do zwrócenia, ale może to być cokolwiek (na przykład secondsAtBirth
, seconds
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 wyjścia $second
operatora.
Kiedy to zrobisz, argument zostanie przekazany do $second
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 sekundy 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: {
$second: { date: "$born", timezone: "Asia/Kabul" }
},
brisbane: {
$second: { date: "$born", timezone: "Australia/Brisbane" }
}
}
}
]
)
Wynik:
{ "kabul" : 15, "brisbane" : 15 }
Biorąc pod uwagę, że zmiana strefy czasowej nie wpływa na część sekund, wynik jest taki sam.
Przesunięcie UTC
W tym przykładzie używamy przesunięcia UTC.
db.pets.aggregate(
[
{
$project: {
_id: 0,
"utcOffset+04:30": {
$second: { date: "$born", timezone: "+04:30" }
},
"utcOffset+05:45": {
$second: { date: "$born", timezone: "+05:45" }
}
}
}
]
)
Wynik:
{ "utcOffset+04:30" : 15, "utcOffset+05:45" : 15 }
Zwróć sekundy z ObjectId
Możesz użyć $second
aby zwrócić część sekund 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ć $second
aby zwrócić sekundę, w której nasz dokument został utworzony (a dokładniej, gdy _id
wartość ObjectId pola została utworzona).
Przykład:
db.pets.aggregate(
[
{
$project:
{
"timeStamp": { $toDate: "$_id"},
"second": { $second: "$_id" }
}
}
]
).pretty()
Wynik:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "timeStamp" : ISODate("2021-01-19T01:11:35Z"), "second" : 35 }
Widzimy, że dokument powstał w 35 sekundzie (11 minuta 1 godziny doby).
W tym przypadku użyłem również $toDate
operator potoku agregacji, aby zwrócić część znacznika czasu ObjectId.