$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.

CategoriaData
Versão do MongoDB1.0+
Idioma do Exemplomongosh (Shell)

📝 Sintaxe

{ $millisecond: { date: <expressão de data>, timezone: <fuso horário> } }

⚙️ Parâmetros

dateObrigatório; a expressão de data.
timezoneOpcional; 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

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.
Web-Tutorial.com

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

100%