No MongoDB, o
$millisecond
operador de pipeline de agregação retorna a parte de milissegundos de uma data como um número inteiro entre 0
e 999
. Opcionalmente, você pode especificar um fuso horário a ser usado para o resultado.
O
$millisecond
O operador aceita uma data (como Date, Timestamp ou ObjectId) ou um documento que especifica a data e o fuso horário a serem usados. Exemplo
Suponha que tenhamos uma coleção chamada
pets
com o seguinte documento:{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "name" : "Fetch", "born" : ISODate("2020-12-31T23:30:15.123Z") }
Podemos executar o seguinte código para extrair a porção de milissegundos do
born
campo nesse documento. db.pets.aggregate(
[
{
$project:
{
_id: 0,
birthMilliSecond: { $millisecond: "$born" }
}
}
]
)
Resultado:
{ "birthMilliSecond" : 123 }
Aqui, usei
birthMilliSecond
como o nome do campo a ser retornado, mas pode ser qualquer coisa (como milliSecondsAtBirth
, milliSeconds
, etc). O
_id
campo é retornado por padrão ao usar projeções no MongoDB, mas neste exemplo eu escondi explicitamente o _id
campo usando _id: 0
. Especificar um fuso horário
Você pode especificar um fuso horário a ser usado para a saída do
$millisecond
operador. Quando você faz isso, o argumento é passado para
$millisecond
deve ter a seguinte forma:{ date: <dateExpression>, timezone: <tzExpression> }
Onde
<dateExpression>
é a data a ser usada e <tzExpression>
é o fuso horário a ser usado. O fuso horário pode ser especificado usando o identificador de fuso horário Olson (por exemplo,
"Europe/London"
, "GMT"
) ou o deslocamento UTC (por exemplo, "+02:30"
, "-1030"
). Identificador de fuso horário Olson
Aqui está um exemplo que gera os milissegundos em dois fusos horários diferentes, cada um usando os IDs de fuso horário Olson:
db.pets.aggregate(
[
{
$project: {
_id: 0,
kabul: {
$millisecond: { date: "$born", timezone: "Asia/Kabul" }
},
brisbane: {
$millisecond: { date: "$born", timezone: "Australia/Brisbane" }
}
}
}
]
)
Resultado:
{ "kabul" : 123, "brisbane" : 123 }
Visto que a mudança de fuso horário não afeta a porção de milissegundos, o resultado é o mesmo.
Deslocamento UTC
Neste exemplo, usamos o deslocamento UTC.
db.pets.aggregate(
[
{
$project: {
_id: 0,
"utcOffset+04:30": {
$millisecond: { date: "$born", timezone: "+04:30" }
},
"utcOffset+05:45": {
$millisecond: { date: "$born", timezone: "+05:45" }
}
}
}
]
)
Resultado:
{ "utcOffset+04:30" : 123, "utcOffset+05:45" : 123 }
Retorne os milissegundos de um ObjectId
Você pode usar
$millisecond
para retornar a parte de milissegundos de um ObjectId. Os valores ObjectId são valores hexadecimais de 12 bytes que consistem em:
- Um valor de carimbo de data/hora de 4 bytes, representando a criação do ObjectId, medido em segundos desde a época do Unix.
- Um valor de 5 bytes é aleatório
- Um contador de incremento de 3 bytes, inicializado com um valor aleatório.
Para recapitular, nosso documento se parece com isso:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "name" : "Fetch", "born" : ISODate("2020-12-31T23:30:15.123Z") }
Este documento contém um ObjectId. Podemos, portanto, usar
$millisecond
para retornar a parte de milissegundos desse ObjectId. No entanto, como mencionado, a parte do fuso horário do ObjectId é medida apenas em segundos desde a época do Unix e, portanto, não inclui uma parte de milissegundos.
Exemplo:
db.pets.aggregate(
[
{
$project:
{
"timeStamp": { $toDate: "$_id"},
"millisecond": { $millisecond: "$_id" }
}
}
]
).pretty()
Resultado:
{ "_id" : ObjectId("600631c7c8eb4369cf6ad9c8"), "timeStamp" : ISODate("2021-01-19T01:11:35Z"), "millisecond" : 0 }
Podemos ver que o timestamp não inclui uma porção de milissegundos e o resultado é
0
. Nesse caso, também usei o
$toDate
operador de pipeline de agregação para retornar a parte de carimbo de data/hora do ObjectId.