O que é timestamp Unix? Guia simples

Se você já olhou para uma resposta de API, um log de servidor ou uma exportação de banco de dados e se perguntou o que significa um número como 1700000000, você já encontrou um timestamp Unix. Ele parece uma sequência aleatória de dígitos, mas é uma das formas mais simples de os computadores acompanharem o tempo. Em resumo: o que é timestamp Unix? É o número de segundos que se passaram desde a meia-noite de 1 de janeiro de 1970, Tempo Universal Coordenado (UTC). Esse momento é chamado de época Unix, e quase todos os sistemas modernos contam o tempo a partir dele.

Este guia explica o que é um timestamp Unix, por que os programadores o usam em vez de uma data normal, onde você vai encontrá-lo e como convertê-lo de volta em uma data que você consiga ler.

O que é timestamp Unix? Segundos desde 1970, explicado

Um timestamp Unix é um único número inteiro que conta os segundos decorridos desde 00:00:00 UTC de 1 de janeiro de 1970. Esse ponto de partida é conhecido como época Unix. O timestamp 0 significa exatamente 1 de janeiro de 1970, 00:00:00 UTC. O timestamp 1 significa um segundo depois. O timestamp 1700000000 significa 1,700,000,000 segundos após a época — o que corresponde a 14 de novembro de 2023, 22:13:20 UTC.

Timestamps negativos também são possíveis: -1 significa um segundo antes da época, ou 31 de dezembro de 1969, 23:59:59 UTC — datas anteriores a 1970 são simplesmente contadas para trás. O número aumenta em um a cada segundo: no início de novembro de 2026, o timestamp Unix atual é aproximadamente 1,794,000,000, cerca de 1.79 bilhão de segundos desde 1970.

Por que 1 de janeiro de 1970? Os engenheiros que construíram o Unix no início dos anos 1970 o escolheram como um ponto de partida conveniente, próximo ao nascimento do sistema, e ele ficou. Hoje, os timestamps Unix são usados pelo Linux, macOS, Android, pela maioria dos servidores web e bancos de dados, e por linguagens de Python a JavaScript. Como a contagem é sempre em UTC, o número é o mesmo em qualquer lugar da Terra — dois sistemas em fusos horários diferentes sempre concordam sobre quando algo aconteceu.

Essa independência de fuso horário é a verdadeira razão de os timestamps estarem em toda parte. Uma data escrita como "03/04/2026" significa 3 de abril na maior parte do mundo e 4 de março nos Estados Unidos. Um timestamp não tem esse problema. Ele também facilita os cálculos: para encontrar o tempo entre dois eventos, basta subtrair um número do outro. A diferença entre 1700000000 e 1699996400 é 3,600 — exatamente uma hora.

Onde você vai encontrar timestamps (APIs, logs)

Depois que você sabe o que procurar, os timestamps Unix aparecem em toda parte. Estes são os lugares onde é mais provável encontrar um.

APIs e dados JSON. Quando um aplicativo conversa com outro pela internet, as datas geralmente são enviadas como timestamps. Uma API de clima pode retornar "sunrise": 1699945200, um serviço de pagamentos pode registrar uma transação em "created": 1700000000, e uma API de rede social pode marcar cada postagem com um número em vez de uma data legível.

Logs de servidores e aplicativos. Servidores web, bancos de dados e aplicativos registram eventos com timestamps para que os engenheiros possam reconstruir exatamente o que aconteceu e quando. Uma linha de log pode dizer 1700000000 ERROR payment failed. Como o número não tem fuso horário, os logs de servidores de Frankfurt, Singapura e Virgínia podem ser combinados em uma única linha do tempo sem confusão.

Tokens de login e segurança. Os tokens que mantêm você conectado também carregam timestamps. Um JSON Web Token (JWT) contém os campos iat (emitido em) e exp (expira em), ambos timestamps Unix, e o seu aplicativo compara o timestamp atual com o de expiração para decidir se a sua sessão ainda é válida.

Cookies, caches e agendamentos. Os cookies armazenam os horários de expiração como timestamps, os caches decidem se os dados armazenados estão desatualizados comparando-os, e tarefas agendadas, como lembretes, costumam ser armazenadas como "executar no timestamp X". Se um número em um arquivo de configuração ou exportação tem dez dígitos e começa com 1, provavelmente é um timestamp Unix.

Como converter um timestamp Unix em uma data legível

Converter um timestamp Unix em uma data legível é simples: um timestamp é apenas segundos desde 1 de janeiro de 1970, então qualquer ferramenta que conheça esse ponto de partida pode fazer o cálculo para você. A maneira mais fácil é usar um conversor — cole o número e ele mostra a data na hora. Você pode converter qualquer timestamp Unix em uma data legível com o conversor gratuito de timestamp Unix da Toolinga, que funciona nos dois sentidos: de timestamp para data, e de data para timestamp.

Se preferir calcular por conta própria, aqui está um exemplo resolvido. Pegue o timestamp 1700000000. Divida por 86,400, o número de segundos em um dia (60 × 60 × 24): 1,700,000,000 ÷ 86,400 = 19,675.9… dias desde a época — aproximadamente 53 anos e 10½ meses após 1 de janeiro de 1970, o que nos leva a meados de novembro de 2023. A parte fracionária do dia (0.9…) × 86,400 dá os segundos dentro daquele dia: cerca de 80,000 segundos, ou 22 horas, 13 minutos e 20 segundos. O resultado: 14 de novembro de 2023, 22:13:20 UTC. Na prática, ninguém faz isso à mão — o código faz: em Python, datetime.fromtimestamp(1700000000, timezone.utc); em JavaScript, new Date(1700000000 * 1000) (note o * 1000 — o JavaScript trabalha em milissegundos).

Segundos de 10 dígitos vs milissegundos de 13 dígitos

Nem todo timestamp que você encontra conta segundos. Alguns sistemas contam milissegundos, o que produz um número de 13 dígitos. O mesmo momento — 14 de novembro de 2023, 22:13:20 UTC — é 1700000000 em segundos, mas 1700000000000 em milissegundos. A correção é simples: se um timestamp tem 13 dígitos, divida-o por 1,000 para obter os segundos. Uma verificação rápida ajuda: se o seu conversor mostra uma data no ano 55,000, você quase certamente alimentou milissegundos onde ele esperava segundos.

Os fusos horários importam na conversão. Um timestamp Unix em si não tem fuso horário — ele é sempre UTC —, mas a data que você vê depende de onde você está. 1700000000 são 22:13:20 em Londres (UTC), mas 17:13:20 no mesmo dia em Nova York (UTC−5) e 03:13:20 na manhã seguinte em Karachi (UTC+5). O conversor de timestamp Unix mostra o resultado em UTC — ajuste-o pelo seu deslocamento local para obter a sua hora local.

O problema de 2038 em 60 segundos

Muitos sistemas mais antigos armazenam timestamps Unix como um inteiro com sinal de 32 bits — um número que pode conter valores de −2,147,483,648 até 2,147,483,647. Esse valor máximo corresponde a 19 de janeiro de 2038, 03:14:07 UTC. Um segundo depois, o contador transborda: ele volta para −2,147,483,648, que o sistema lê como 13 de dezembro de 1901. Esse é o problema do ano 2038, a versão do mundo dos timestamps do bug do ano 2000.

Quão preocupado você deve ficar? Menos do que as manchetes sugerem. A maioria dos sistemas modernos — sistemas operacionais de 64 bits, bancos de dados atuais e linguagens de programação recentes — já armazena timestamps como números de 64 bits, que não vão transbordar por cerca de 292 bilhões de anos. O risco está nos sistemas embarcados mais antigos, no software legado e nos formatos de arquivo que ainda usam timestamps de 32 bits, e bancos, companhias aéreas e operadores de infraestrutura vêm migrando há anos. Para o usuário comum, o problema de 2038 é uma curiosidade — e um lembrete de por que a forma como armazenamos o tempo importa. Se você quiser verificar o que um timestamp específico significa, pode consultá-lo em segundos com o conversor de timestamp Unix e ver a data por conta própria.

Converta instantaneamente

Agora você sabe o que significa timestamp Unix: uma contagem de segundos desde 1 de janeiro de 1970, uma forma sem fuso horário de os computadores concordarem sobre o tempo, e um número que você continuará encontrando em APIs, logs e bancos de dados. Você consegue reconhecê-lo de relance — dez dígitos, começando com 1 —, diferenciar segundos de milissegundos e convertê-lo em uma data. Da próxima vez que um arquivo de log mostrar 1700000000, você saberá que significa 14 de novembro de 2023.

Coloque em prática: acesse o conversor gratuito de timestamp Unix da Toolinga, cole qualquer timestamp de 10 ou 13 dígitos que você tenha encontrado e veja a data e a hora exatas que ele representa — ou digite uma data e obtenha o timestamp de volta. É gratuito, instantâneo e funciona nos dois sentidos.

O que é timestamp Unix em termos simples?

Um timestamp Unix é o número de segundos desde 1 de janeiro de 1970, 00:00:00 UTC. Por exemplo, 1700000000 significa 14 de novembro de 2023, 22:13:20 UTC. É como os computadores armazenam datas como um único número, para que sistemas em fusos horários diferentes sempre concordem.

Quantos dígitos tem um timestamp Unix?

Em segundos, um timestamp Unix tem 10 dígitos nas décadas de 2020 e 2030 — por exemplo, 1700000000. Em milissegundos, tem 13 dígitos, como 1700000000000. Se você vir 13 dígitos, divida por 1,000 para obter os segundos.

Qual é o timestamp Unix atual?

Ele aumenta em um a cada segundo. No início de novembro de 2026, é aproximadamente 1,794,000,000 — você pode ver o valor ao vivo em qualquer conversor de timestamp Unix.

O que acontece em 2038 com os timestamps Unix?

Em 19 de janeiro de 2038, às 03:14:07 UTC, um timestamp Unix com sinal de 32 bits atinge seu valor máximo de 2,147,483,647 e transbordaria em sistemas que ainda usam armazenamento de 32 bits. A maioria dos sistemas modernos de 64 bits não é afetada.