$millisecond (Obter Milissegundo)
Última atualização: 2026-10-09
$millisecond (Obter Milissegundo)
$millisecond retorna a parte de milissegundos de uma data (0 a 999) — um extrator de tempo de alta granularidade. Raramente usado sozinho, ajuda em ordenação precisa, deduplicação ou reconstrução de timestamps em milissegundos. Retorna um inteiro sem zero à esquerda. timezone não afeta o valor (milissegundos são independentes de zona), mas ainda é aceito sintaticamente. Combine com $second para rótulos em nível de milissegundo.
| Categoria | Data |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
{ $millisecond: { date: <expressão de data>, timezone: <fuso horário> } }
⚙️ Parâmetros
| date | Obrigatório; a expressão de data. |
|---|---|
| timezone | Opcional; não afeta o valor de milissegundos. |
Retorno:O milissegundo (0-999); null se date for null.
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// $millisecond: milissegundos de timestamps de sensores
db.sensors.aggregate([
{ $project: { ms: { $millisecond: '$ts' } } }
])
Saída:
{ "_id": 1, "ms": 320 }
{ "_id": 2, "ms": 0 }
📌 Notas
- Intervalo de 0 a 999 sem zero à esquerda
- Milissegundos são independentes de zona; timezone não muda nada
- Combine com $second para rótulos em nível de milissegundo
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QQual é o intervalo?
ADe 0 a 999.
QO fuso horário afeta os milissegundos?
ANão — milissegundos são uma quantidade pura de tempo, independente de zona.
QComo formatar um milissegundo de três dígitos?
AEle retorna um inteiro cru; preencha com $concat quando necessário.