Conversor de Timestamp Unix

O Timestamp Unix, também chamado de Unix time, POSIX time ou Epoch time, é o número de segundos que se passaram desde 1º de janeiro de 1970, às 00:00:00 UTC. Esse instante é o Epoch, e o timestamp dele é 0. O número não carrega fuso horário: o mesmo valor vale no Brasil e no Japão, e cada sistema converte para a hora local só na hora de mostrar. Como é um inteiro só, dá para guardar, ordenar e subtrair datas sem ambiguidade, e por isso ele aparece em bancos de dados, logs, APIs e tokens JWT.

A escala. Em segundos, que é o padrão Unix clássico, o valor atual tem 10 dígitos. Em milissegundos, a escala do Date.now() do JavaScript e de muitas APIs, o mesmo instante é 1.000 vezes maior e tem 13 dígitos. Os dois contam a partir de 1970, em UTC. A data 2024-01-15T10:30:00Z é 1705314600 em segundos e 1705314600000 em milissegundos. Trocar uma escala pela outra é o erro mais comum: os milissegundos lidos como segundos caem no ano 56009, e os segundos lidos como milissegundos caem em 20/01/1970.

O Unix Epoch é o ponto de origem do Timestamp Unix: 1º de janeiro de 1970, às 00:00:00 UTC, cujo timestamp é 0. Datas anteriores têm valor negativo. O dia 1º de janeiro de 1969, por exemplo, é -31536000, porque 1969 teve 365 dias de 86.400 segundos. O POSIX fixa essa origem e manda contar todo dia com exatamente 86.400 segundos, sem os segundos bissextos. Esta ferramenta converte valores negativos normalmente, até o ano 1.

ISO 8601 é a norma internacional da ISO para escrever data e hora. O formato completo é AAAA-MM-DDTHH:MM:SS.sssZ: o T separa a data da hora e o Z indica UTC, como em 2024-01-15T10:30:00Z. No lugar do Z pode vir o deslocamento do fuso, como -03:00 para Brasília, e então 2024-01-15T07:30:00-03:00 é o mesmo instante. Como a ordem vai do ano ao segundo, texto nesse formato ordena como data, e é por isso que ele é o mais usado entre sistemas. A linha ISO 8601 (UTC) do resultado sai sempre com o Z.

Porque são relógios diferentes. A linha Data/hora local usa o fuso configurado no sistema operacional de quem abre a página, e o UTC é a referência universal. No Brasil, 12:00 UTC aparece como 09:00 no horário de Brasília, que está em UTC-3 o ano todo desde que o Decreto 9.772, de 25 de abril de 2019, encerrou o horário de verão. Uma data antiga que caia num período de horário de verão mostra diferença de 2 horas, porque naquela época o relógio era adiantado. O Timestamp Unix em si não muda: ele é sempre contado em UTC.

Use new Date('2024-01-15T10:30:00Z').getTime() para ter o valor em milissegundos, ou Math.floor(new Date('2024-01-15T10:30:00Z').getTime() / 1000) para ter em segundos. O instante atual é Date.now(), em milissegundos. Prefira o formato ISO 8601 com o Z no fim, porque sem ele o JavaScript lê a data com hora como horário local. No terminal do Linux, date +%s mostra o timestamp atual em segundos, e date -u -d @1705314600 faz a conversão de volta para data.

Pela ordem de grandeza, e o resultado mostra a escolha na linha Escala usada. Com até 10 dígitos o valor é lido como segundos, com 13 dígitos como milissegundos e com 16 dígitos como microssegundos, a escala de sistemas que registram eventos com precisão de milionésimo de segundo. Os cortes exatos ficam em 10 elevado a 11 e 10 elevado a 14. Você pode fixar a escala à mão em vez de usar a detecção. Se a escala escolhida destoar do tamanho do número, aparece um aviso dizendo o que a ferramenta calculou e o que o número provavelmente é.

Porque o resultado não seria uma data, seria um número disfarçado de data. O valor 1705314600000, lido como segundos, cai no ano 56009. Mostrar isso como conversão bem-sucedida esconderia o erro de escala, que é o mais comum com timestamp. A ferramenta recusa e explica: o número tem 13 dígitos, o tamanho de um valor em milissegundos como o do Date.now(), e sugere trocar a escala ou usar a detecção automática. A faixa aceita vai do ano 1 ao ano 9999.

Não. O construtor Date do JavaScript aceita '2024-02-30' e devolve 1º de março, calado, porque ele acumula o dia que sobrou. Esta ferramenta valida o dia contra o número real de dias do mês, com a regra completa de ano bissexto (divisível por 4, exceto séculos não divisíveis por 400). Por isso 2024-02-29 é aceito, 2023-02-29 e 1900-02-29 são recusados, e 2000-02-29 é aceito. Hora acima de 23 e minuto acima de 59 também são recusados.

Como UTC, e o resultado diz isso em texto. O JavaScript trata '2024-01-15' como UTC e '2024-01-15T10:30:00' como horário local, uma incoerência da própria linguagem que faz o mesmo texto virar timestamps diferentes conforme o fuso do computador. Aqui a regra é uma só: sem fuso escrito, a leitura é UTC. Para informar outro fuso, escreva o deslocamento na data, como 2024-01-15T07:30:00-03:00. O resultado mostra a data em UTC e também em horário de Brasília.

É o limite dos sistemas que guardam o Timestamp Unix num inteiro de 32 bits com sinal. O maior valor que cabe nesse formato é 2.147.483.647, que corresponde a 19/01/2038 às 03:14:07 UTC. Um segundo depois, o número dá a volta e vira -2.147.483.648, que é 13/12/1901 às 20:45:52 UTC. Sistemas atuais guardam o tempo em 64 bits e não têm esse problema, mas equipamentos antigos e formatos de arquivo com campo de 32 bits ainda existem. Esta ferramenta usa o número de 64 bits do JavaScript e converte datas depois de 2038 sem erro.

São o mesmo instante escrito em três relógios. Data UTC é o horário universal no formato em inglês usado em cabeçalhos HTTP, como Mon, 15 Jan 2024 10:30:00 GMT. Data/hora em Brasília sai da base de fusos America/Sao_Paulo e não depende do seu computador, por isso é a linha certa para comparar com outra pessoa. Data/hora local usa o fuso do sistema operacional de quem abriu a página: num computador configurado para Lisboa, ela mostra a hora de Lisboa. As linhas Dia (local) e Hora (local) repetem essa data local em duas partes.