Timestamp (Interno)
Última atualização: 2026-10-09
Timestamp (Interno)
Timestamp é um tipo interno do MongoDB: um valor de 64 bits formado por um segundo Unix de 4 bytes mais um incremento de 4 bytes. Ele sustenta o oplog de replica sets, os change streams e outros mecanismos internos. As aplicações devem armazenar pontos no tempo como Date. Desde a 4.4, Timestamps não podem aparecer em condições de consulta. Construa com `Timestamp({ t: segundos, i: incremento })`.
| Categoria | Tipos BSON |
|---|---|
| Versão do MongoDB | 1.0+ |
| Idioma do Exemplo | mongosh (Shell) |
📝 Sintaxe
Timestamp({ t: <seconds>, i: <increment> })
Timestamp(0, 0) // atalhoRetorno：Retorna um valor Timestamp que expõe t (segundos) e i (incremento)
▶ Exemplo
Execute os comandos abaixo no seu mongosh local (requer um mongod em execução):
// Timestamp: constrói e lê campos
const ts = Timestamp({ t: 1758700000, i: 1 })
print(ts.t, ts.i) // segundos e incrementoSaída：
1758700000 1📌 Notas
- Armazene pontos no tempo de aplicação como Date, não Timestamp
- Desde a 4.4, Timestamps são proibidos em condições de consulta
- O oplog e os metadados fragmentados dependem da ordenação por Timestamp
🏷️ Tags Relacionados
💡 Casos Relacionados
Mais casos práticos em breve.
📚 Tutoriais Relacionados
❓ Perguntas Frequentes
QQual é a diferença entre Timestamp e Date?
ADate armazena um ponto no tempo em milissegundos; Timestamp adiciona um contador de incremento e serve a mecanismos internos como o oplog.
QAs aplicações podem armazenar Timestamps?
ANão recomendado — é interno ao MongoDB; armazene o tempo de negócio como Date.
QPor que consultar um Timestamp gera erro?
ADesde a 4.4, campos Timestamp são proibidos em condições de consulta — uma mudança drástica; migre para Date.
