Timestamp Unix (Epoch Time) Explicado
Um timestamp Unix resume qualquer instante em um único inteiro: o número de segundos desde 1º de janeiro de 1970 às 00:00 UTC. Essa simplicidade esconde algumas armadilhas — unidade, fuso horário e tamanho do inteiro. Este guia explica o que o número significa, como lê-lo e onde as conversões costumam falhar.
O Que É Exatamente um Timestamp Unix?
Um timestamp Unix (também chamado de epoch time) conta os segundos desde 1970-01-01T00:00:00Z, a epoch do Unix. A contagem é feita em UTC, então o número é o mesmo em qualquer país no mesmo instante. O valor pode ser negativo para momentos anteriores a 1970 e é sempre uma duração, nunca uma data formatada. 1700000000 não é "um horário em Londres"; é um instante absoluto que cada fuso horário mostra de forma diferente.
Segundos, Milissegundos ou Microssegundos?
O mesmo instante pode ser escrito com precisões diferentes: segundos (1700000000, 10 dígitos), milissegundos (1700000000000, 13), microssegundos (16) ou nanossegundos (19). O Date.now() do JavaScript, o System.currentTimeMillis() do Java e muitas APIs usam milissegundos; date +%s e a maioria das ferramentas Unix usam segundos. Conte os dígitos como primeira verificação. Passar segundos para uma API de milissegundos data o valor em janeiro de 1970, enquanto passar milissegundos para uma API de segundos o joga dezenas de milhares de anos no futuro. Divida ou multiplique por 1000 antes de converter.
Por Que o Mesmo Timestamp Mostra Horários Diferentes?
O timestamp não depende de fuso horário; a exibição depende. 1700000000 aparece como 22:13 UTC em 14 de novembro de 2023, mas como 19:13 em São Paulo e 23:13 em Madri. É o mesmo instante, não um erro de conversão. Armazene timestamps em UTC (ou como inteiro) e aplique o fuso do usuário apenas ao formatar. Strings ISO 8601 como 2023-11-14T22:13:20Z deixam o fuso explícito e são mais fáceis de ler em logs.
O Que São o Bug de 2038 e os Segundos Bissextos?
Duas armadilhas clássicas permanecem. O tempo Unix ignora segundos bissextos: todo dia é tratado como exatamente 86.400 segundos, então o contador pode ficar um segundo defasado de UTC após a inserção de um segundo bissexto. O bug de 2038 é um overflow: sistemas que guardam o valor em um inteiro assinado de 32 bits esgotam a capacidade em 2147483647, que é 2038-01-19T03:14:07Z, e voltam para 1901. Use inteiros de 64 bits ou strings ISO 8601 em esquemas novos, e verifique se dispositivos embarcados e bancos mais antigos sobrevivem a essa data.
Como Converter Timestamps Sem Erros?
Defina a unidade antes de gravar o valor, mantenha os timestamps brutos em UTC e converta apenas nas bordas do sistema. Um conversor ajuda a checar um número suspeito: cole o valor e veja lado a lado a data, a unidade e a string ISO. Use o Conversor de Epoch e Timestamp para converter segundos, milissegundos e microssegundos nos dois sentidos — tudo roda no seu navegador.