6 sposobów na uzyskanie roku z daty w MongoDB

MongoDB udostępnia sporo operatorów potoku agregacji do pracy z datami. Obejmuje to operatorów, którzy wyodrębniają pewne części dat, takie jak rok, miesiąc, dzień itp.

Istnieje również kilka metod MongoDB, które umożliwiają iterację przez kursor i zastosowanie funkcji JavaScript. Pozwala to zatem na użycie JavaScript do wyodrębnienia wartości dat i części dat itp. z pola.

W tym artykule przedstawiono 6 sposobów na zwrócenie części roku z daty w MongoDB.

Przykładowe dane

Załóżmy, że mamy kolekcję o nazwie cats z następującymi dokumentami:

{ "_id" : 1, "name" : "Scratch", "born" : ISODate("2021-01-03T23:30:15.123Z") }
{ "_id" : 2, "name" : "Meow", "born" : ISODate("2019-12-08T04:00:12Z") }
{ "_id" : 3, "name" : "Fluffy", "born" : ISODate("2020-09-24T10:30:00Z") }

Poniższe przykłady pokazują różne opcje zwracania części roku z born pola tych dokumentów.

$year Operator

$year operator jest najbardziej oczywistym wyborem do wyodrębnienia części roku z daty. Jest specjalnie zaprojektowany, aby zwrócić dokument z częścią roku w dacie.

Możemy uruchomić następujący kod, aby zwrócić rok z born w powyższym dokumencie.

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

Wynik:

{ "birthYear" : 2021 }
{ "birthYear" : 2019 }
{ "birthYear" : 2020 }

Możesz również określić strefę czasową, używając $year operator.

Zobacz MongoDB $year aby uzyskać więcej informacji i przykładów.

$dateToString Operator

$dateToString operator konwertuje obiekt daty na ciąg znaków zgodnie z formatem określonym przez użytkownika. Użytkownik może zatem określić, że w razie potrzeby zwracana jest tylko część roku.

Dla każdej części daty istnieją specyfikatory formatu. %Y specyfikator formatu zwraca rok.

Przykład:

db.cats.aggregate(
   [
     {
       $project: {
         _id: 0,
          birthYear: { $dateToString: { format: "%Y", date: "$born" } }
       }
     }
   ]
)

Wynik:

{ "birthYear" : "2021" }
{ "birthYear" : "2019" }
{ "birthYear" : "2020" }

Mogliśmy podać więcej specyfikatorów formatu, aby uwzględnić w wyniku części dat, ale ponieważ w tym artykule interesuje nas tylko wyodrębnienie roku, użyliśmy tylko jednego specyfikatora formatu.

Zobacz MongoDB $dateToString aby uzyskać więcej informacji i przykładów.

$dateToParts Operator

$dateToParts Operator zwraca dokument, który zawiera części składowe danej wartości daty BSON jako indywidualne właściwości. Zwracane właściwości to year , month , day , hour , minute , second i millisecond .

Uzbrojeni w tę wiedzę, możemy użyć $dateToParts w jednym etapie potoku, a następnie dodaj kolejny etap potoku, który wyodrębni year część.

Oto, co $dateToParts zwraca po nasze trzy dokumenty:

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

Wynik:

{
	"dateParts" : {
		"year" : 2021,
		"month" : 1,
		"day" : 3,
		"hour" : 23,
		"minute" : 30,
		"second" : 15,
		"millisecond" : 123
	}
}
{
	"dateParts" : {
		"year" : 2019,
		"month" : 12,
		"day" : 8,
		"hour" : 4,
		"minute" : 0,
		"second" : 12,
		"millisecond" : 0
	}
}
{
	"dateParts" : {
		"year" : 2020,
		"month" : 9,
		"day" : 24,
		"hour" : 10,
		"minute" : 30,
		"second" : 0,
		"millisecond" : 0
	}
}

Te dane można przekazać do następnego etapu w potoku, aby wyodrębnić tylko year pole.

Oto, co się stanie, jeśli dodamy kolejną projekcję tylko na year pole:

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

Wynik:

{ "birthYear" : 2021 }
{ "birthYear" : 2019 }
{ "birthYear" : 2020 }

Oczywiście nie jest to tak zwięzłe, jak korzystanie z poprzednich opcji. Jednak w zależności od tego, co robisz w swoim potoku, takie podejście może być przydatną opcją.

$dateToParts operator akceptuje również iso8601 parametr, który modyfikuje dokument wyjściowy tak, aby używał pól daty tygodnia ISO.

Zobacz MongoDB $dateToParts aby uzyskać więcej informacji i przykładów.

forEach() Metoda

Możesz użyć cursor.forEach() do iteracji przez kursor za pomocą metody JavaScript, takiej jak getFullYear() lub getUTCFullYear() aby zwrócić tylko wartość roku.

db.cats.find().forEach(
  function(c) {
    print(
      c.born.getFullYear()
      );
  }
);

Wynik:

2021
2019
2020

Poprzednie opcje zwracają cały dokument zawierający parę nazwa/wartość. Ta opcja zwraca tylko rzeczywistą wartość roku, a nie cały dokument.

map() Metoda

cursor.map() Metoda stosuje funkcję do każdego dokumentu odwiedzanego przez kursor i łączy wartości w tablicę.

Przykład:

db.cats.find().map(
  function(c) {
    c = c.born.getFullYear();
    return c;
  }
);

Wynik:

[ 2021, 2019, 2020 ]

$isoWeekYear Operator

Jeśli chcesz zwrócić rok w formacie ISO 8601, użyj $isoWeekYear . Rok ISO 8601 rozpoczyna się w poniedziałek pierwszego tygodnia i kończy w niedzielę ostatniego tygodnia.

Przykład:

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

Wynik:

{ "birthIsoWeekYear" : NumberLong(2020) }
{ "birthIsoWeekYear" : NumberLong(2019) }
{ "birthIsoWeekYear" : NumberLong(2020) }

Zauważ, że pierwszy rok to teraz 2020, a nie 2021, jak w poprzednich przykładach. Nie wszystkie lata będą inne, gdy użyjesz $isoWeekYear , ponieważ zależy to od danej daty.