Este artigo apresenta 5 maneiras de retornar a parte de milissegundos 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 milissegundos do
born
campo desses documentos. O $millisecond
Operador
O
$millisecond
O operador é projetado especificamente para retornar um documento com a parte de milissegundos de uma determinada data. Podemos executar o seguinte código para retornar a parte de milissegundos do
born
campo no documento acima. db.cats.aggregate(
[
{
$project:
{
_id: 0,
birthMillisecond: { $millisecond: "$born" }
}
}
]
)
Resultado:
{ "birthMillisecond" : 123 } { "birthMillisecond" : 112 } { "birthMillisecond" : 7 }
O
$millisecond
operador também aceita um timezone
argumento. Veja MongoDB
$millisecond
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 milissegundos seja retornada, se necessário. Existem especificadores de formato para cada parte da data. O
%L
especificador de formato retorna a parte de milissegundos (3 dígitos, preenchido com zero). Exemplo:
db.cats.aggregate(
[
{
$project: {
_id: 0,
birthMillisecond: { $dateToString: { format: "%L", date: "$born" } }
}
}
]
)
Resultado:
{ "birthMillisecond" : "123" } { "birthMillisecond" : "112" } { "birthMillisecond" : "007" }
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 millisecond
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
millisecond
campo na etapa seguinte. Veja o que acontece se adicionarmos outra projeção por apenas
millisecond
campo:db.cats.aggregate(
[
{
$project:
{
_id: 0,
dateParts: { $dateToParts: { date: "$born" } }
}
},
{
$project:
{
birthMillisecond: "$dateParts.millisecond"
}
}
]
)
Resultado:
{ "birthMillisecond" : 123 } { "birthMillisecond" : 112 } { "birthMillisecond" : 7 }
Portanto, sempre que você usar
$dateToParts
em seu pipeline, você terá acesso ao millisecond
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 getMilliseconds()
ou getUTCMilliseconds()
para retornar apenas os milissegundos. db.cats.find().forEach(
function(c) {
print(
c.born.getUTCMilliseconds()
);
}
);
Resultado:
123 112 7
O
getUTCSeconds()
O método JavaScript retorna um número inteiro, entre 0 e 999, representando a parte de milissegundos do objeto de data fornecido. O
getMilliseconds()
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 de milissegundos 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.getUTCMilliseconds();
return c;
}
);
Resultado:
[ 123, 112, 7 ]