MongoDB $isoWeekYear

W MongoDB $isoWeekYear Operator potoku agregacji zwraca rok numeracji tygodni ISO dla danej wartości daty. Jest to numer roku w formacie ISO 8601.

Podczas korzystania z $isoWeekYear operatora, możesz opcjonalnie określić strefę czasową, która będzie używana dla wyniku.

$isoWeekYear 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 cats z następującym dokumentem:

{
	"_id" : ObjectId("6008c9a5c8eb4369cf6ad9cc"),
	"name" : "Scratch",
	"born" : ISODate("2021-01-03T23:30:15.123Z")
}

Możemy uruchomić następujący kod, aby wyodrębnić rok ISO z born pole w tym dokumencie.

db.cats.aggregate(
  [
    {
      $project:
        {
          _id: 0,
          birthIsoWeekYear: { $isoWeekYear: "$born" }
        }
    }
  ]
)

Wynik:

{ "birthIsoWeekYear" : NumberLong(2020) } 

Widzimy, że rok ISO to w rzeczywistości 2020, mimo że data określa 2021. Dzieje się tak, ponieważ rok ISO nie kończy się, dopóki nie skończy się ostatni tydzień. A w tym przypadku tydzień rozpoczął się pod koniec ubiegłego roku i jeszcze się nie skończył. Tak działają lata ISO.

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

Gdy to zrobisz, argument zostanie przekazany do $isoWeekYear 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 rok ISO w dwóch różnych strefach czasowych, z których każda używa identyfikatorów stref czasowych Olson:

db.cats.aggregate(
  [
    {
      $project: {
          _id: 0,
          honolulu: { 
            $isoWeekYear: { date: "$born", timezone: "Pacific/Honolulu" }
            },
          auckland: { 
            $isoWeekYear: { date: "$born", timezone: "Pacific/Auckland" }
            }
        }
    }
  ]
)

Wynik:

{ "honolulu" : NumberLong(2020), "auckland" : NumberLong(2021) } 

W takim przypadku data przesuwa się do następnego roku ISO, gdy używasz Pacific/Auckland strefa czasowa.

Przesunięcie UTC

Oto ten sam przykład, ale tym razem używamy przesunięcia UTC.

db.cats.aggregate(
  [
    {
      $project: {
          _id: 0,
          "utcOffset-1000": { 
            $isoWeekYear: { date: "$born", timezone: "-1000" }
            },
          "utcOffset+1200": { 
            $isoWeekYear: { date: "$born", timezone: "+1200" }
            }
        }
    }
  ]
)

Wynik:

{ "utcOffset-1000" : NumberLong(2020), "utcOffset+1200" : NumberLong(2021) } 

Zwróć rok ISO z ObjectId

Możesz użyć $isoWeekYear aby zwrócić część roku ISO 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("6008c9a5c8eb4369cf6ad9cc"),
	"name" : "Scratch",
	"born" : ISODate("2021-01-03T23:30:15.123Z")
}

Ten dokument zawiera ObjectId. Dlatego możemy użyć $isoWeekYear aby zwrócić rok ISO, w którym nasz dokument został utworzony (a dokładniej, gdy _id wartość ObjectId pola została utworzona).

Przykład:

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

Wynik:

{
	"_id" : ObjectId("6008c9a5c8eb4369cf6ad9cc"),
	"timeStamp" : ISODate("2021-01-21T00:24:05Z"),
	"isoWeekYear" : NumberLong(2021)
}

Widzimy, że dokument powstał w roku ISO 2021.

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

Informacje o systemie dat tygodnia ISO

System daty tygodnia ISO to system kalendarza, który jest częścią normy daty i godziny ISO 8601 wydanej przez Międzynarodową Organizację Normalizacyjną (ISO). System określa rok tygodnia na szczycie kalendarza gregoriańskiego, definiując notację porządkową tygodni w roku.

Lata numeracji tygodni ISO mają 52 lub 53 pełne tygodnie. Oznacza to, że w roku jest 364 lub 371 dni, zamiast zwykłych 365 lub 366 dni.

Tygodnie ISO zaczynają się od poniedziałku. Rok każdego tygodnia ISO to rok gregoriański, w którym przypada czwartek. Numery tygodni ISO zaczynają się od 1 z tygodniem, który zawiera pierwszy czwartek roku.