6 начина да получите годината от дата в MongoDB

MongoDB предоставя доста оператори на тръбопроводи за агрегиране за работа с дати. Това включва оператори, които извличат определени части от дати, като година, месец, ден и т.н.

Има също така няколко метода на MongoDB, които ви позволяват да итерирате през курсор и да прилагате функция на JavaScript. Следователно това ви позволява да използвате JavaScript за извличане на стойности за дата и части от дата и т.н. от поле.

Тази статия представя 6 начина за връщане на частта от годината от дата в MongoDB.

Примерни данни

Да предположим, че имаме колекция, наречена cats със следните документи:

{ "_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") }

Следващите примери демонстрират различни опции за връщане на частта от годината от born поле на тези документи.

$year Оператор

$year операторът е най-очевидният избор за извличане на частта от годината от дата. Той е специално проектиран да връща документ с част от годината на дата.

Можем да изпълним следния код, за да върнем годината от born поле в горния документ.

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

Резултат:

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

Можете също да посочите часовата зона, когато използвате $year оператор.

Вижте MongoDB $year за повече информация и примери.

$dateToString Оператор

$dateToString оператор преобразува обект за дата в низ според зададен от потребителя формат. Следователно потребителят може да посочи, че ако е необходимо, се връща само частта от годината.

Има спецификатори на формат за всяка част от датата. %Y спецификаторът на формат връща годината.

Пример:

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

Резултат:

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

Можехме да предоставим повече спецификатори на формат, за да включим части от дата в резултата, но тъй като се интересуваме само от извличането на годината в тази статия, използвахме само един спецификатор на формат.

Вижте MongoDB $dateToString за повече информация и примери.

$dateToParts Оператор

$dateToParts операторът връща документ, който съдържа съставните части на дадена стойност на датата на BSON като отделни свойства. Върнатите свойства са year , month , day , hour , minute , second и millisecond .

Въоръжени с това знание, можем да използваме $dateToParts в един етап на конвейера, след което добавете друг етап на конвейера, който извлича year част.

Ето какво е $dateToParts връща за нашите три документа:

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

Резултат:

{
	"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
	}
}

Тези данни могат да бъдат предадени на следващия етап в тръбопровода, за да се извлече само year поле.

Ето какво се случва, ако добавим друга прогноза само за year поле:

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

Резултат:

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

Това очевидно не е толкова кратко, колкото използването на предишните опции. Въпреки това, в зависимост от това, което правите във вашия тръбопровод, този подход може да бъде удобен вариант.

$dateToParts операторът също така приема iso8601 параметър, който модифицира изходния документ, за да използва полета за дата на ISO седмицата.

Вижте MongoDB $dateToParts за повече информация и примери.

forEach() Метод

Можете да използвате cursor.forEach() за да преминете през курсора, като използвате метод на JavaScript, като getFullYear() или getUTCFullYear() за да върне само стойността на годината.

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

Резултат:

2021
2019
2020

Предишните опции връщат цял ​​документ, който съдържа двойка име/стойност. Тази опция връща само действителната стойност на годината, а не целия документ.

map() Метод

cursor.map() Методът прилага функция към всеки документ, посетен от курсора, и комбинира стойностите в масив.

Пример:

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

Резултат:

[ 2021, 2019, 2020 ]

$isoWeekYear Оператор

Ако трябва да върнете годината във формат ISO 8601, използвайте $isoWeekYear . Годината по ISO 8601 започва с понеделник от седмица 1 и завършва с неделята на последната седмица.

Пример:

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

Резултат:

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

Забележете, че първата година вече е 2020 вместо 2021, както в предишните примери. Не всички години ще бъдат различни, когато използвате $isoWeekYear , защото зависи от въпросната дата.