MongoDB $milisekundy

W MongoDB $millisecond Operator potoku agregacji zwraca milisekundową część daty jako liczbę całkowitą z przedziału 0 i 999 .

Opcjonalnie możesz określić strefę czasową, która będzie używana dla wyniku.

$millisecond 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ć milisekundową część z born pole w tym dokumencie.

db.pets.aggregate(
  [
    {
      $project:
        {
          _id: 0,
          birthMilliSecond: { $millisecond: "$born" }
        }
    }
  ]
)

Wynik:

{ "birthMilliSecond" : 123 }

Tutaj użyłem birthMilliSecond jako nazwę pola do zwrócenia, ale może to być cokolwiek (na przykład milliSecondsAtBirth , milliSeconds 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 $millisecond operatora.

Kiedy to zrobisz, argument zostanie przekazany do $millisecond 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 milisekundy w dwóch różnych strefach czasowych, z których każda używa identyfikatorów strefy czasowej Olson:

db.pets.aggregate(
  [
    {
      $project: {
          _id: 0,
          kabul: { 
            $millisecond: { date: "$born", timezone: "Asia/Kabul" }
            },
          brisbane: { 
            $millisecond: { date: "$born", timezone: "Australia/Brisbane" }
            }
        }
    }
  ]
)

Wynik:

{ "kabul" : 123, "brisbane" : 123 } 

Biorąc pod uwagę, że zmiana strefy czasowej nie wpływa na część milisekund, 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": { 
            $millisecond: { date: "$born", timezone: "+04:30" }
            },
          "utcOffset+05:45": { 
            $millisecond: { date: "$born", timezone: "+05:45" }
            }
        }
    }
  ]
)

Wynik:

{ "utcOffset+04:30" : 123, "utcOffset+05:45" : 123 }

Zwróć milisekundy z ObjectId

Możesz użyć $millisecond aby zwrócić część milisekund 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ć $millisecond aby zwrócić część milisekundową z tego ObjectId.

Jednak, jak wspomniano, część ObjectId dotycząca strefy czasowej jest mierzona tylko w sekundach od epoki Uniksa, a zatem nie obejmuje części milisekundowej.

Przykład:

db.pets.aggregate(
  [
    {
      $project:
        {
          "timeStamp": { $toDate: "$_id"},
          "millisecond": { $millisecond: "$_id" }
        }
    }
  ]
).pretty()

Wynik:

{
	"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
	"timeStamp" : ISODate("2021-01-19T01:11:35Z"),
	"millisecond" : 0
}

Widzimy, że znacznik czasu nie zawiera części milisekundowej, a wynik to 0 .

W tym przypadku użyłem również $toDate operator potoku agregacji, aby zwrócić część znacznika czasu ObjectId.