Este artigo apresenta 5 maneiras de retornar a parte de segundos 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:20.112Z") } { "_id" : 3, "name" : "Fluffy", "born" : ISODate("2020-09-24T10:45:01.007Z") }
Os exemplos a seguir demonstram várias opções para retornar a parte de segundos do
born
campo desses documentos. O $second
Operador
O
$second
operador é projetado especificamente para retornar um documento com a parte de segundos de uma determinada data. Podemos executar o seguinte código para retornar a parte de segundos do
born
campo no documento acima. db.cats.aggregate(
[
{
$project:
{
_id: 0,
birthSecond: { $second: "$born" }
}
}
]
)
Resultado:
{ "birthSecond" : 15 } { "birthSecond" : 20 } { "birthSecond" : 1 }
Você também pode especificar o fuso horário ao usar o
$second
operador. Veja MongoDB
$second
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 de segundos seja retornada, se necessário. Existem especificadores de formato para cada parte da data. O
%S
especificador de formato retorna a segunda parte (2 dígitos, preenchido com zero). Exemplo:
db.cats.aggregate(
[
{
$project: {
_id: 0,
birthSecond: { $dateToString: { format: "%S", date: "$born" } }
}
}
]
)
Resultado:
{ "birthSecond" : "15" } { "birthSecond" : "20" } { "birthSecond" : "01" }
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 adicione outro estágio de pipeline que extraia o second
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" : 20, "millisecond" : 112 } } { "dateParts" : { "year" : 2020, "month" : 9, "day" : 24, "hour" : 10, "minute" : 45, "second" : 1, "millisecond" : 7 } }
Esse resultado pode ser passado para o próximo estágio no pipeline e, portanto, podemos extrair apenas o
second
campo na etapa seguinte. Veja o que acontece se adicionarmos outra projeção apenas por
second
campo:db.cats.aggregate(
[
{
$project:
{
_id: 0,
dateParts: { $dateToParts: { date: "$born" } }
}
},
{
$project:
{
birthSecond: "$dateParts.second"
}
}
]
)
Resultado:
{ "birthSecond" : 15 } { "birthSecond" : 20 } { "birthSecond" : 1 }
Portanto, sempre que você usar
$dateToParts
em seu pipeline, você terá acesso ao second
campo (e as outras partes da data) 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 getSeconds()
ou getUTCSeconds()
para retornar apenas os segundos. db.cats.find().forEach(
function(c) {
print(
c.born.getUTCSeconds()
);
}
);
Resultado:
15 20 1
O
getUTCSeconds()
O método JavaScript retorna um número inteiro, entre 0 e 59, representando os segundos na data especificada de acordo com o horário universal. O
getSeconds()
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 segundos 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.getUTCSeconds();
return c;
}
);
Resultado:
[ 15, 20, 1 ]