MongoDB $dateToParts

W MongoDB $dateToParts Operator potoku agregacji zwraca części daty podanej daty.

Dokładniej, zwraca dokument, który zawiera części składowe danej wartości daty BSON jako indywidualne właściwości.

Części daty zwrócone przez $dateToParts są year , month , day , hour , minute , second i millisecond .

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

$dateToParts 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 zwrócić różne części daty z born pole w tym dokumencie.

db.pets.aggregate(
  [
    {
      $project:
        {
          _id: 0,
          dateParts: { $dateToParts: { date: "$born" } }
        }
    }
  ]
).pretty()

Wynik:

{
	"dateParts" : {
		"year" : 2020,
		"month" : 12,
		"day" : 31,
		"hour" : 23,
		"minute" : 30,
		"second" : 15,
		"millisecond" : 123
	}
}

Widzimy, że każda część daty jest zwracana w swoim własnym polu.

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

Gdy to zrobisz, argument zostanie przekazany do $dateToParts 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 części daty 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,
          honolulu: { 
            $dateToParts: { date: "$born", timezone: "Pacific/Honolulu" }
            },
          auckland: { 
            $dateToParts: { date: "$born", timezone: "Pacific/Auckland" }
            }
        }
    }
  ]
).pretty()

Wynik:

{
	"honolulu" : {
		"year" : 2020,
		"month" : 12,
		"day" : 31,
		"hour" : 13,
		"minute" : 30,
		"second" : 15,
		"millisecond" : 123
	},
	"auckland" : {
		"year" : 2021,
		"month" : 1,
		"day" : 1,
		"hour" : 12,
		"minute" : 30,
		"second" : 15,
		"millisecond" : 123
	}
}

W takim przypadku data przesuwa się do przodu na następny rok/miesiąc/tydzień/dzień/godzinę przy użyciu Pacific/Auckland strefa czasowa.

Przesunięcie UTC

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

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

Wynik:

{
	"utcOffset-1000" : {
		"year" : 2020,
		"month" : 12,
		"day" : 31,
		"hour" : 13,
		"minute" : 30,
		"second" : 15,
		"millisecond" : 123
	},
	"utcOffset+1200" : {
		"year" : 2021,
		"month" : 1,
		"day" : 1,
		"hour" : 11,
		"minute" : 30,
		"second" : 15,
		"millisecond" : 123
	}
}

Części daty tygodnia ISO

Możesz użyć iso8601: true aby zmodyfikować dokument wyjściowy tak, aby używał pól daty tygodnia ISO. Data ta opiera się na normie ISO 8601.

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ć pola daty ISO z born pole w tym dokumencie.

Oto przykład do zademonstrowania:

db.pets.aggregate(
  [
    {
      $project: {
          _id: 0,
          dateParts: { 
            $dateToParts: { 
              date: "$born"
            }
          },
          datePartsISO: { 
            $dateToParts: { 
              date: "$born",
              iso8601: true
            }
          }
      }
    }
  ]
).pretty()

Wynik:

{
	"dateParts" : {
		"year" : 2020,
		"month" : 12,
		"day" : 31,
		"hour" : 23,
		"minute" : 30,
		"second" : 15,
		"millisecond" : 123
	},
	"datePartsISO" : {
		"isoWeekYear" : 2020,
		"isoWeek" : 53,
		"isoDayOfWeek" : 4,
		"hour" : 23,
		"minute" : 30,
		"second" : 15,
		"millisecond" : 123
	}
}

Pierwszy dokument wyjściowy wykorzystuje normalne dane wyjściowe. Drugi dokument wykorzystuje pola i wartości daty tygodnia ISO.

Zwróć części daty z ObjectId

Możesz użyć $dateToParts aby zwrócić części daty 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ć $dateToParts aby zwrócić części daty, na podstawie daty utworzenia naszego dokumentu (a dokładniej, kiedy _id wartość ObjectId pola została utworzona).

Przykład:

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

Wynik:

{
	"_id" : ObjectId("600631c7c8eb4369cf6ad9c8"),
	"timeStamp" : ISODate("2021-01-19T01:11:35Z"),
	"dateParts" : {
		"year" : 2021,
		"month" : 1,
		"day" : 19,
		"hour" : 1,
		"minute" : 11,
		"second" : 35,
		"millisecond" : 0
	}
}

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