В MongoDB, $minute
Операторът на конвейера за агрегиране връща минутната част от дата като число между 0
и 59
.
По избор можете да посочите часова зона, която да използвате за резултата.
$minute
операторът приема или дата (като дата, клеймо за време или ObjectId), или документ, който посочва датата и часовата зона за използване.
Пример
Да предположим, че имаме колекция, наречена pets
със следния документ:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "name" : "Fetch", "born" : ISODate("2020-12-31T23:30:15.123Z") }
Можем да изпълним следния код, за да извлечем минутната част от born
поле в този документ.
db.pets.aggregate(
[
{
$project:
{
_id: 0,
birthMinute: { $minute: "$born" }
}
}
]
)
Резултат:
{ "birthMinute" : 30 }
Тук използвах birthMinute
като име на полето, което трябва да се върне, но това може да е всичко (като minutesAtBirth
, minutes
и т.н.).
_id
полето се връща по подразбиране при използване на проекции в MongoDB, но в този пример изрично скрих _id
поле с помощта на _id: 0
.
Посочете часова зона
Можете да посочите часова зона, която да използвате за изхода на $minute
оператор.
Когато направите това, аргументът се предава на $minute
трябва да бъде в следната форма:
{ date: <dateExpression>, timezone: <tzExpression> }
Където <dateExpression>
е датата за използване и <tzExpression>
е часовата зона за използване.
Часовата зона може да бъде определена с помощта на идентификатора на часовата зона на Олсън (напр. "Europe/London"
, "GMT"
) или отместването на UTC (напр. "+02:30"
). , "-1030"
).
Идентификатор на часовата зона на Олсън
Ето пример, който извежда минутата в две различни часови зони, всяка от които използва идентификаторите на часовата зона на Olson:
db.pets.aggregate(
[
{
$project: {
_id: 0,
kabul: {
$minute: { date: "$born", timezone: "Asia/Kabul" }
},
katmandu: {
$minute: { date: "$born", timezone: "Asia/Katmandu" }
}
}
}
]
)
Резултат:
{ "kabul" : 0, "katmandu" : 15 }
Изместване на UTC
В този пример използваме UTC отместване.
db.pets.aggregate(
[
{
$project: {
_id: 0,
"utcOffset+04:30": {
$minute: { date: "$born", timezone: "+04:30" }
},
"utcOffset+05:45": {
$minute: { date: "$born", timezone: "+05:45" }
}
}
}
]
)
Резултат:
{ "utcOffset+04:30" : 0, "utcOffset+05:45" : 15 }
Връщане на минутите от ObjectId
Можете да използвате $minute
за да върнете минутната част от ObjectId.
Стойностите на ObjectId са 12 байтови шестнадесетични стойности, които се състоят от:
- 4 байтова стойност на времеви печат, представляваща създаването на ObjectId, измерена в секунди след епохата на Unix.
- 5 байта е произволна стойност
- Брояч с нарастващ 3 байта, инициализиран на произволна стойност.
За да обобщим, нашият документ изглежда така:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "name" : "Fetch", "born" : ISODate("2020-12-31T23:30:15.123Z") }
Този документ съдържа ObjectId. Следователно можем да използваме $minute
за да върнем минутата, в която е създаден нашият документ (или по-точно, когато _id
стойността ObjectId на полето е създадена).
Пример:
db.pets.aggregate(
[
{
$project:
{
"timeStamp": { $toDate: "$_id"},
"minute": { $minute: "$_id" }
}
}
]
).pretty()
Резултат:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "timeStamp" : ISODate("2021-01-19T01:11:35Z"), "minute" : 11 }
Виждаме, че документът е създаден на 11-та минута от 1-вия час на деня.
В този случай използвах и $toDate
оператор на тръбопровода за агрегиране, за да върне частта от клеймото за време на ObjectId.