O que é um carimbo de data/hora Unix? Uma explicação completa do tempo epoch
Resposta rápida
Um carimbo de data/hora Unix é o número de segundos desde 1º de janeiro de 1970, 00:00:00 UTC (a época Unix). É independente do fuso horário e fácil de comparar. JavaScript usa milissegundos (13 dígitos); Unix e a maioria dos APIs usam segundos (10 dígitos). Use nosso conversor de carimbo de data/hora gratuito para converter entre carimbos de data/hora e datas legíveis por humanos.
Introdução
Um carimbo de data / hora Unix (também chamado de época Unix, hora POSIX ou hora Unix) é o número de segundos decorridos desde 1º de janeiro de 1970, 00:00:00 UTC - um momento conhecido como época Unix. Os carimbos de data e hora são amplamente usados em sistemas operacionais, bancos de dados, logs e APIs porque são independentes de fuso horário (sempre UTC), fáceis de comparar (comparação simples de números inteiros) e compactos. No entanto, eles não são legíveis por humanos — 1693526400 não significa nada sem conversão. Este guia explica o que são carimbos de data/hora e como usá-los.
Passo a passo
-
Entenda a época Unix
A época Unix é 1º de janeiro de 1970, 00:00:00 Tempo Universal Coordenado (UTC). Um carimbo de data/hora Unix é a contagem de segundos a partir deste momento. Os carimbos de data/hora positivos são posteriores à época; carimbos de data/hora negativos (suportados por alguns sistemas) estão antes dele.
-
Distinguir segundos de milissegundos
Os carimbos de data/hora Unix são normalmente em segundos (10 dígitos a partir de 2026, por exemplo, 1693526400). Date.now() e Date.getTime() do JavaScript retornam milissegundos (13 dígitos, por exemplo, 1693526400000). Sempre verifique qual unidade um API espera – misturá-las é o bug de carimbo de data/hora mais comum.
-
Entenda a independência do fuso horário
Os carimbos de data/hora Unix são sempre UTC. Eles não dependem do fuso horário do usuário. Para exibir um carimbo de data/hora em um fuso horário específico, converta-o em uma data e aplique a diferença de fuso horário. Isso torna os carimbos de data/hora ideais para armazenamento e comparação.
-
Aprenda sobre o problema do ano 2038
Sistemas que usam inteiros assinados de 32 bits para carimbos de data/hora irão estourar em 19 de janeiro de 2038, 03:14:07 UTC - o 'problema Y2038'. Sistemas que usam números inteiros de 64 bits ou números JavaScript (flutuantes de 64 bits) não são afetados. Os sistemas modernos são amplamente seguros para o Y2038, mas os sistemas embarcados legados podem não ser.
Exemplos
Carimbo de data e hora para uma data conhecida
Entrada: 01/09/2023 00:00:00 UTC
Saída: 1693526400 (segundos) ou 1693526400000 (milissegundos)
A época Unix
Entrada: 01-01-1970 00:00:00 UTC
Saída: 0
Limite do problema Y2038
Entrada: 19/01/2038 03:14:07 UTC
Saída: 2147483647 (máximo inteiro assinado de 32 bits)
Problemas comuns
- Misturando segundos e milissegundos —JavaScript usa milissegundos (Date.now()), Unix e a maioria dos APIs usam segundos. Divida por 1000 para converter ms em segundos; multiplique por 1000 para o inverso.
- Confusão de fuso horário — os carimbos de data e hora são UTC. Ao exibir, converta para o fuso horário local do usuário ou especifique UTC. Não aplique compensações ao carimbo de data/hora bruto.
- O problema do ano 2038 – carimbos de data e hora inteiros assinados de 32 bits estouram em 19/01/2038. Use inteiros de 64 bits ou números JavaScript para evitar isso.
- Carimbos de data/hora negativos — datas anteriores a 01/01/1970 têm carimbos de data/hora negativos. Alguns sistemas não os suportam.
Dicas
- Sempre verifique se um API espera segundos ou milissegundos — este é o bug de carimbo de data/hora mais comum.
- Use strings ISO 8601 (por exemplo, "2023-09-01T00:00:00Z") para carimbos de data/hora legíveis por humanos em APIs; use a época Unix para armazenamento e computação.
- JavaScript Date.now() retorna milissegundos; divida por 1000 e piso para obter os segundos.
- Use nosso conversor de carimbo de data/hora para converter carimbos de data/hora e datas legíveis por humanos em seu navegador.