O que é um timestamp Unix? Um guia claro para desenvolvedores

Você abre um arquivo de log, uma resposta de API ou uma linha de banco de dados e encontra um campo como 1755432000 onde esperava uma data. Esse número é um timestamp Unix, uma das formas mais comuns pelas quais os computadores armazenam um momento no tempo. Assim que você entende o que ele representa, ele deixa de ser enigmático e se torna um dos formatos de data mais simples que existem. Este guia explica o tempo Unix e mostra como convertê-lo nos dois sentidos com o Conversor de timestamp Unix.

O que um timestamp Unix realmente é

Um timestamp Unix é o número de segundos que se passaram desde um único momento de referência fixo: a meia-noite de 1 de janeiro de 1970, em UTC. Esse ponto de referência é chamado de época Unix. Então 0 é a própria época, 60 é um minuto depois dela e 1755432000 é o tanto de segundos que se passaram desde então.

Como é contado em UTC, um timestamp Unix não carrega nenhum peso de fuso horário próprio. O mesmo número significa o mesmo instante em qualquer lugar do planeta. Um servidor em Tóquio e um servidor em Nova York que registram o mesmo evento vão armazenar um timestamp idêntico, mesmo que a hora local do relógio seja diferente. O fuso horário só importa quando você converte esse número de volta para uma data legível por humanos a fim de exibi-la.

Por que os sistemas armazenam o tempo dessa maneira

Armazenar o tempo como um simples número inteiro resolve uma pilha de problemas que as datas em texto criam:

• A comparação é trivial. Para descobrir qual de dois eventos aconteceu primeiro, você compara dois números. Sem análise sintática, sem lógica de calendário.
• A matemática é fácil. Adicionar uma hora significa somar 3600. Encontrar o intervalo entre dois eventos é uma única subtração.
• Não há ambiguidade. Uma string como 03/04/05 poderia ser três datas diferentes dependendo da região. Um timestamp tem exatamente um significado.
• É compacto e ordenável. Ordenar linhas por um número é rápido e te dá a ordem cronológica correta de graça.

É por isso que bancos de dados, formatos de log, metadados de arquivos, campos de expiração de JWT e incontáveis APIs se apoiam no tempo Unix nos bastidores e só convertem para um formato amigável nas pontas.

Segundos contra milissegundos, a armadilha clássica

Aqui está o detalhe que pega quase todo mundo. O tempo Unix clássico conta segundos, mas muitos sistemas, o JavaScript em particular, contam milissegundos desde a mesma época. Um timestamp em milissegundos é simplesmente o valor em segundos multiplicado por 1000, então ele tem três dígitos a mais.

A verificação rápida de sanidade: um timestamp atual em segundos tem cerca de 10 dígitos, enquanto um timestamp atual em milissegundos tem cerca de 13 dígitos. Se a sua data convertida cair em 1970, você quase certamente forneceu milissegundos a uma ferramenta que esperava segundos, ou o contrário. Saber qual unidade você tem em mãos evita datas erradas por um fator de mil.

Como converter um timestamp em data e vice-versa

Você não precisa fazer essa aritmética à mão. O gratuito Conversor de timestamp Unix roda inteiramente no seu navegador, então os valores que você cola nunca são enviados.

1. Para transformar um timestamp em uma data legível, cole o número e leia a data e a hora humanas que ele representa.
2. Para ir no sentido contrário, insira uma data e hora de calendário e receba de volta o timestamp Unix correspondente.
3. Fique de olho na unidade. Se a sua fonte estiver em milissegundos, leve em conta os três dígitos a mais para que o seu resultado não fique décadas fora do lugar.

Como funciona offline na aba, você pode converter com segurança timestamps de logs internos ou registros privados sem enviá-los a um servidor.

Fazendo mais do que converter

Converter um único timestamp muitas vezes é só o primeiro passo. Assim que você tem duas datas reais, normalmente quer saber o intervalo entre elas. A Calculadora de diferença entre datas informa quantos dias separam duas datas, enquanto a Calculadora de duração de tempo lida com intervalos medidos em horas e minutos, o que é útil quando você está raciocinando sobre quanto tempo um processo rodou entre dois timestamps de log.

Para o caso específico e comum de descobrir a idade de algo ou de alguém a partir de uma data inicial, a Calculadora de idade te dá anos, meses e dias diretamente, então você não precisa converter um timestamp de nascimento e contar à mão.

A versão curta

Um timestamp Unix é apenas a contagem de segundos desde 1 de janeiro de 1970 UTC, o que torna armazenar, comparar e fazer cálculos com o tempo algo simples e inequívoco. Fique de olho na distinção entre segundos e milissegundos, lembre-se de que o número bruto não carrega fuso horário e converta nas pontas quando um humano precisar lê-lo. O Conversor de timestamp Unix lida com os dois sentidos instantaneamente e de forma privada no seu navegador, de modo que aquele número misterioso nos seus logs vira uma data real em um segundo.