Este artigo apresenta 5 maneiras de retornar a parte de minutos de um objeto Date no MongoDB.
Dados de amostra
Suponha que tenhamos uma coleção chamada
cats
com os seguintes documentos:{ "_id" : 1, "name" : "Scratch", "born" : ISODate("2021-01-03T23:30:15.123Z") } { "_id" : 2, "name" : "Meow", "born" : ISODate("2019-12-08T04:00:47Z") } { "_id" : 3, "name" : "Fluffy", "born" : ISODate("2020-09-24T10:45:00Z") }
Os exemplos a seguir demonstram várias opções para retornar a parte de minutos do
born
campo desses documentos. O $minute
Operador
O
$minute
operador é projetado especificamente para devolver um documento com a parte de minutos de uma determinada data. Podemos executar o seguinte código para retornar a parte de minutos do
born
campo no documento acima. db.cats.aggregate(
[
{
$project:
{
_id: 0,
birthMinute: { $minute: "$born" }
}
}
]
)
Resultado:
{ "birthMinute" : 30 } { "birthMinute" : 0 } { "birthMinute" : 45 }
Você também pode especificar o fuso horário ao usar o
$minute
operador. Veja MongoDB
$minute
para mais informações e exemplos. A $dateToString
Operador
O
$dateToString
O operador converte um objeto de data em uma string de acordo com um formato especificado pelo usuário. O usuário pode, portanto, especificar que apenas a parte dos minutos seja retornada, se necessário. Existem especificadores de formato para cada parte da data. O
%M
especificador de formato retorna a parte de minutos. Exemplo:
db.cats.aggregate(
[
{
$project: {
_id: 0,
birthMinute: { $dateToString: { format: "%M", date: "$born" } }
}
}
]
)
Resultado:
{ "birthMinute" : "30" } { "birthMinute" : "00" } { "birthMinute" : "45" }
Você também pode usar
%Z
para retornar o deslocamento de minutos do UTC como um número. Veja MongoDB
$dateToString
para mais informações e exemplos. As $dateToParts
Operador
O
$dateToParts
O operador retorna um documento que contém as partes constituintes de um determinado valor BSON Date como propriedades individuais. As propriedades retornadas são year
, month
, day
, hour
, minute
, second
e millisecond
. Portanto, poderíamos usar
$dateToParts
em um estágio de pipeline e, em seguida, adicione outro estágio de pipeline que extraia o minute
papel. Veja o que
$dateToParts
retornos para nossos três documentos:db.cats.aggregate(
[
{
$project:
{
_id: 0,
dateParts: { $dateToParts: { date: "$born" } }
}
}
]
).pretty()
Resultado:
{ "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" : 47, "millisecond" : 0 } } { "dateParts" : { "year" : 2020, "month" : 9, "day" : 24, "hour" : 10, "minute" : 45, "second" : 0, "millisecond" : 0 } }
Esse resultado pode ser passado para o próximo estágio no pipeline para extrair apenas o
minute
campo. Veja o que acontece se adicionarmos outra projeção apenas para o
minute
campo:db.cats.aggregate(
[
{
$project:
{
_id: 0,
dateParts: { $dateToParts: { date: "$born" } }
}
},
{
$project:
{
birthMinute: "$dateParts.minute"
}
}
]
)
Resultado:
{ "birthMinute" : 30 } { "birthMinute" : 0 } { "birthMinute" : 45 }
Então, se você usar
$dateToParts
em seu pipeline, você terá acesso ao minute
campo (e todos os outros campos) na próxima etapa. Veja MongoDB
$dateToParts
para mais informações e exemplos. O forEach()
Método
Você pode usar
cursor.forEach()
para iterar através do cursor, usando um método JavaScript como getMinutes()
ou getUTCMinutes()
para retornar apenas os minutos. db.cats.find().forEach(
function(c) {
print(
c.born.getUTCMinutes()
);
}
);
Resultado:
30 0 45
O
getUTCMinutes()
O método JavaScript retorna um número inteiro, entre 0 e 59, representando os minutos na data especificada de acordo com o horário universal. O
getMinutes()
O método retorna na hora local. Você também pode notar que as opções anteriores retornam um documento inteiro que contém um par nome/valor, enquanto esta opção retorna apenas o valor real dos minutos e não o documento inteiro.
O map()
Método
O
cursor.map()
O método aplica uma função a cada documento visitado pelo cursor e combina os valores em uma matriz. Exemplo:
db.cats.find().map(
function(c) {
c = c.born.getUTCMinutes();
return c;
}
);
Resultado:
[ 30, 0, 45 ]