Conversor de timestamp Unix

O que é um timestamp Unix

Um timestamp Unix — também chamado tempo epoch ou tempo POSIX — é um único número que conta quantos segundos passaram desde as 00:00:00 UTC de 1 de janeiro de 1970, um instante conhecido como epoch de Unix. Por ser um só inteiro, sem fuso horário, sem calendário e sem formatação, é o formato a que os computadores recorrem sempre que um instante tem de ser guardado, ordenado, comparado ou enviado pela rede. É o que está por trás da coluna «created_at» da sua base de dados, dos claims «iat» e «exp» de um JWT, do mtime de um ficheiro e dos timestamps de praticamente qualquer registo que venha a ler.

A contrapartida é que um número nu não diz nada a uma pessoa. 1716197600 é um instante perfeitamente válido, mas num relance não sabe se foi na terça-feira passada ou há três anos. Essa tradução, nos dois sentidos, é o que esta ferramenta faz.

Segundos ou milissegundos: a ambiguidade que morde

A convenção original do Unix conta segundos inteiros, e é isso que obtém de date +%s numa shell, de time() em PHP e de time.time() em Python depois de truncado. JavaScript, Java e muitos outros contam milissegundos: Date.now() devolve um número mil vezes maior. Ambos se chamam «timestamp», e confundi-los é um dos erros de datas mais comuns que existem.

A falha é silenciosa e não ruidosa. Leia um valor em milissegundos como segundos e a data aterra dezenas de milhares de anos no futuro; leia um valor em segundos como milissegundos e tudo se desmorona para janeiro de 1970. Nenhum dos dois lança um erro — simplesmente obtém uma data errada com todo o aspeto de ser verdadeira.

Esta ferramenta deduz pela ordem de grandeza do número e depois diz-lhe o que deduziu, mesmo ao lado do resultado. Os segundos epoch de hoje têm dez dígitos e os milissegundos treze, por isso o palpite está quase sempre certo — mas «quase» não chega para um valor que está prestes a colar num relatório de erro, e é por isso que a leitura está sempre visível e sempre a um clique de ser trocada.

Fusos horários, UTC e porque «local» é escorregadio

Um timestamp Unix não tem fuso horário. Identifica um instante, e esse mesmo instante é simultaneamente 09:33 em Londres, 11:33 em Jerusalém e 18:33 em Tóquio. O fuso horário não faz parte do valor: é a lente através da qual olha para ele.

Por isso esta ferramenta mostra várias lentes ao mesmo tempo. UTC é a referência neutra em que todos os servidores e registos concordam. A sua hora local é a que o seu próprio dispositivo indica, mostrada com o nome do fuso (por exemplo Europe/Berlin) para saber sempre que lente a produziu — a deteção acontece no seu navegador, por isso quem visita de Berlim vê a hora de Berlim e quem visita de Tóquio vê a de Tóquio. A terceira linha é qualquer fuso que escolha da base de dados IANA completa, e é a linha que quer quando está a ler o registo de um servidor que vive noutro sítio.

• UTC — a referência em que todos os sistemas concordam, e o correto para guardar e registar.
• Local — o mesmo instante tal como o seu dispositivo o vê, identificado com o fuso detetado.
• Um fuso à sua escolha — para ler registos e rastreios de máquinas noutros locais.
• ISO 8601 — o formato de texto de intercâmbio, p. ex. 2024-05-20T09:33:20.000Z.
• Relativo — «há 3 horas», para ter uma noção rápida de quão recente é algo.

Os desvios são mostrados junto a cada hora (+03:00, -04:00) porque não são fixos: a maioria dos fusos desloca-se uma hora com a hora de verão, portanto o mesmo fuso pode dar desvios diferentes em alturas diferentes do ano. Uma data perto de uma mudança é precisamente onde as contas de cabeça falham.

Trabalhar com tempo epoch na prática

Cada linguagem e cada shell tem a sua maneira de produzir e ler valores epoch. Estas vale a pena guardar:

date +%s                         # shell: hora atual em segundos
date -d @1716197600              # shell (GNU): de segundos para data
Date.now()                       # JavaScript: hora atual em MILIssegundos
new Date(1716197600 * 1000)      # JavaScript: de segundos para Date
time.time()                      # Python: segundos, como decimal
datetime.fromtimestamp(1716197600, tz=timezone.utc)
SELECT EXTRACT(EPOCH FROM now()) -- PostgreSQL: segundos

Uma regra prática que evita quase toda a dor com datas: guarde e transmita instantes em UTC — como inteiro epoch ou como cadeia ISO 8601 — e converta para um fuso local só no último momento, quando os mostra mesmo a alguém. Formatar cedo demais é como um erro de fuso horário acaba cozido dentro dos seus dados em vez de ficar na camada de apresentação.

Mais uma coisa que convém saber: um contador de segundos de 32 bits com sinal esgota-se a 19 de janeiro de 2038, o «problema do ano 2038». Os sistemas modernos usam valores de 64 bits e estão seguros, mas os dispositivos embebidos antigos e as colunas de bases de dados herdadas são exatamente onde ainda o pode encontrar.