5 начина да получите час от дата в MongoDB

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

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

Тази статия представя 5 начина за връщане на часовата част от обект Date в 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 поле на тези документи.

$hour Оператор

$hour операторът е специално проектиран да връща документ с часовата част на дадена дата.

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

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

Резултат:

{ "birthHour" : 23 }
{ "birthHour" : 4 }
{ "birthHour" : 10 }

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

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

$dateToString Оператор

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

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

Пример:

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

Резултат:

{ "birthHour" : "23" }
{ "birthHour" : "04" }
{ "birthHour" : "10" }

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

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

$dateToParts Оператор

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

Следователно бихме могли да използваме $dateToParts в един етап на конвейера, след това добавете друг етап на конвейера, който извлича hour част.

Ето какво е $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
	}
}

След това този резултат може да бъде предаден на следващия етап в конвейера, за да се извлече само hour поле.

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

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

Резултат:

{ "birthHour" : 23 }
{ "birthHour" : 4 }
{ "birthHour" : 10 }

Въпросът тук е, ако използвате $dateToParts във вашия тръбопровод вие автоматично имате достъп до часовата част (и всички останали части) на следващия етап.

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

forEach() Метод

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

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

Резултат:

23
4
10

getUTCHours() Методът на JavaScript връща цяло число между 0 и 23, представляващо часовете в дадена дата според универсалното време.

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

map() Метод

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

Пример:

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

Резултат:

[ 9, 14, 20 ]

Може да сте забелязали, че получените часове са различни от предишните примери. Това е така, защото в този пример използвах getHours() JavaScript метод. Този метод връща резултата си според местното време. Бих могъл също толкова лесно да използвам getUTCHours() .