Conversor de timestamp Unix

O tempo Unix conta os segundos decorridos desde 00:00:00 UTC de 1º de janeiro de 1970, ignorando os segundos bissextos. É o formato da maioria das linhas de log, das datas de expiração de tokens, de colunas de banco de dados e de campos de API, e é ilegível sem conversão. Esta ferramenta converte um timestamp em data e vice-versa, mostrando o resultado ao mesmo tempo no seu fuso horário local, em UTC e em ISO 8601.

Como funciona

No modo Timestamp → Data, digite um número e escolha se ele está em segundos ou em milissegundos. A ferramenta multiplica os segundos por 1.000, cria um Date do JavaScript e exibe três representações: a data e a hora locais do seu navegador, o mesmo instante em UTC e a string ISO 8601 terminada em Z. O botão Copiar coloca a forma ISO na área de transferência, já que é a que outros sistemas interpretam sem ambiguidade. Usar agora preenche o horário atual na unidade selecionada.

No modo Data → Timestamp, escolha uma data e uma hora no seletor do navegador. O valor é interpretado no seu fuso horário local, convertido em milissegundos desde o epoch e exibido tanto em segundos inteiros (arredondados para baixo) quanto em milissegundos.

Tudo roda localmente. A representação local depende do fuso horário do seu dispositivo, então duas pessoas convertendo o mesmo número podem ver horários diferentes; as linhas UTC e ISO são iguais para todo mundo.

Segundos, milissegundos e além

Para qualquer data da era atual, um número de dez dígitos está em segundos e um de treze dígitos, em milissegundos. Se a data convertida cair em 1970 ou num futuro distante, é quase certo que você escolheu a unidade errada. System.currentTimeMillis() do Java, Date.now() do JavaScript e a maioria das APIs JSON usam milissegundos; ferramentas POSIX, claims de JWT e muitos bancos de dados usam segundos.

Valores de dezesseis dígitos são microssegundos e de dezenove dígitos são nanossegundos, emitidos por alguns sistemas de tracing e de métricas. A ferramenta não oferece essas unidades: divida antes por 1.000 ou por 1.000.000. Frações de segundo são aceitas na entrada e aparecem na saída ISO com precisão de milissegundo, que é a precisão de um Date do JavaScript.

Timestamps negativos são válidos e representam datas anteriores a 1970. O intervalo representável cobre cerca de ±273 mil anos em torno do epoch, bem mais do que qualquer dado real vai precisar.

Fusos horários e horário de verão

Um timestamp Unix não tem fuso horário: ele identifica um instante. O fuso só importa quando você transforma esse instante em uma data do calendário, e é por isso que a ferramenta mostra o horário local e o UTC lado a lado. Quando uma entrada de log parece deslocada em uma hora, a causa costuma ser que quem gravou usou o horário local e quem leu presumiu UTC, ou que uma mudança de horário de verão aconteceu entre os dois momentos.

É na conversão de data para timestamp que a ambiguidade aparece. Durante a hora que se repete quando os relógios são atrasados, um mesmo horário local corresponde a dois instantes, e o navegador escolhe um deles. Se esse nível de precisão importa, trabalhe em UTC e converta com uma biblioteca adequada em vez de um seletor de data.

Equivalente na linha de comando

O date do GNU converte nos dois sentidos:

date -u -d @1700000000              # Tue Nov 14 22:13:20 UTC 2023
date +%s                            # current Unix time in seconds
date -d '2024-03-01T09:00:00Z' +%s  # ISO string to seconds

No macOS, a primeira forma fica date -r 1700000000.

O ano 2038

Sistemas que armazenam o tempo Unix em um inteiro de 32 bits com sinal estouram às 03:14:07 UTC de 19 de janeiro de 2038. Sistemas operacionais e linguagens modernos usam 64 bits, mas dispositivos embarcados, formatos de arquivo antigos e alguns esquemas de banco de dados não. Se você está projetando um armazenamento hoje, use um inteiro de 64 bits ou um tipo de timestamp de verdade.

Saiba mais

O pacote java.time do Java modela essa distinção diretamente: Instant é o timestamp, ZonedDateTime é o instante mais um fuso e LocalDateTime é um horário de relógio sem fuso nenhum. O guia sobre Optional e a API java.time explica qual usar em cada situação e como converter entre eles com segurança. Os claims exp e iat que você vê no decodificador de JWT são segundos Unix, e a calculadora de idade cuida da aritmética de calendário depois que você tem uma data.