Unix Timestamp explicado: Guia completo da hora Epoch

Se você já depurou uma resposta de API, configurou um log de servidor ou trabalhou com bancos de dados, provavelmente já encontrou um timestamp Unix. Essas longas sequências numéricas como 1700000000 parecem crípticas à primeira vista, mas são, na verdade, uma das formas mais simples e universais de representar um momento no tempo.

Este guia explica o que são timestamps Unix, como a hora epoch funciona e como converter entre timestamps e datas legíveis — com exemplos práticos que você pode usar imediatamente.

O que é um Unix Timestamp?

Um timestamp Unix é um número que representa o total de segundos decorridos desde 1º de janeiro de 1970 às 00:00:00 UTC. Esse ponto de partida é chamado de epoch Unix.

Por exemplo, o timestamp 1700000000 corresponde a 14 de novembro de 2023 às 22:13:20 UTC. Em vez de lidar com anos, meses, dias, horas, minutos e segundos separadamente, um timestamp resume tudo em um único número inteiro.

Também conhecido como hora Unix, hora epoch ou hora POSIX, esse sistema é usado em praticamente todas as linguagens de programação, sistemas operacionais e bancos de dados.

O Epoch Unix explicado

O epoch Unix é a quinta-feira, 1º de janeiro de 1970, 00:00:00 UTC — o momento a partir do qual todos os timestamps Unix começam a contar.

Por que 1970? Quando o Unix foi desenvolvido nos Bell Labs no início dos anos 1970, os criadores precisavam de um ponto de referência. 1º de janeiro de 1970 foi escolhido como uma data inicial prática — recente o suficiente para ser relevante e convenientemente no início de um ano.

Cada segundo decorrido desde aquele momento soma um ao timestamp. Atualmente, já ultrapassamos 1,76 bilhão de segundos desde o epoch.

Segundos vs milissegundos

Uma das fontes de confusão mais comuns é a diferença entre segundos e milissegundos:

Precisão	Dígitos	Exemplo	Usado por
Segundos	10	1700000000	Python, PHP, maioria das APIs
Milissegundos	13	1700000000000	JavaScript, Java, muitas APIs web

Regra prática: Se o seu timestamp tem 10 dígitos, está em segundos. Se tem 13 dígitos, está em milissegundos. Para converter, multiplique ou divida por 1.000.

Como converter Unix Timestamp em data

Converter um timestamp em uma data legível é simples com as ferramentas certas.

Com nosso conversor: Insira o timestamp em nosso Conversor de Unix Timestamp e obtenha a data instantaneamente.

No código:

// JavaScript (espera milissegundos)
const data = new Date(1700000000 * 1000);
console.log(data.toISOString());
// Resultado: "2023-11-14T22:13:20.000Z"

# Python
import datetime
data = datetime.datetime.fromtimestamp(1700000000, tz=datetime.timezone.utc)
print(data.isoformat())
# Resultado: "2023-11-14T22:13:20+00:00"

// PHP
echo date('Y-m-d H:i:s', 1700000000);
// Resultado: "2023-11-14 22:13:20"

Como converter data em Unix Timestamp

A operação inversa — converter uma data em timestamp — é igualmente comum.

// JavaScript
const timestamp = Math.floor(
  new Date("2024-01-15T12:00:00Z").getTime() / 1000
);
console.log(timestamp); // 1705320000

# Python
import datetime
dt = datetime.datetime(2024, 1, 15, 12, 0, 0, tzinfo=datetime.timezone.utc)
print(int(dt.timestamp()))  # 1705320000

// PHP
echo strtotime("2024-01-15T12:00:00+00:00");
// Resultado: 1705320000

Exemplos de Unix Timestamp

Aqui estão alguns timestamps notáveis como referência:

Timestamp	Data (UTC)	Significado
0	1º jan. 1970 00:00:00	O epoch Unix
1000000000	9 set. 2001 01:46:40	O bilionésimo segundo
1234567890	13 fev. 2009 23:31:30	Um valor de teste popular
1700000000	14 nov. 2023 22:13:20	Um número redondo recente
2000000000	18 mai. 2033 03:33:20	Um marco futuro
2147483647	19 jan. 2038 03:14:07	Valor máximo com sinal de 32 bits

Formatos de timestamp comuns

Unix timestamps são apenas uma forma de representar datas. Veja como o mesmo momento aparece em diferentes formatos:

Formato	Exemplo
Unix timestamp	1700000000
ISO 8601	2023-11-14T22:13:20Z
RFC 2822	Tue, 14 Nov 2023 22:13:20 +0000
RFC 3339	2023-11-14T22:13:20+00:00
Legível	14 de novembro de 2023 22:13:20

ISO 8601 é o formato mais usado em APIs e sistemas modernos. O sufixo Z significa «hora Zulu» (UTC).

Unix Timestamp em programação

Cada linguagem importante oferece suporte integrado para trabalhar com timestamps.

JavaScript

// Timestamp atual (milissegundos — dividir por 1000 para segundos)
const agora = Math.floor(Date.now() / 1000);

// Timestamp para data
const data = new Date(1700000000 * 1000);

// Data para timestamp
const ts = Math.floor(new Date("2024-06-15").getTime() / 1000);

Python

import datetime

# Timestamp atual
agora = int(datetime.datetime.now().timestamp())

# Timestamp para data
data = datetime.datetime.fromtimestamp(1700000000, tz=datetime.timezone.utc)

# Data para timestamp
ts = int(datetime.datetime(2024, 6, 15, tzinfo=datetime.timezone.utc).timestamp())

PHP

// Timestamp atual
$agora = time();

// Timestamp para data
echo date('Y-m-d H:i:s', 1700000000);

// Data para timestamp
$ts = strtotime("2024-06-15");

Erros comuns

1. Confundir segundos e milissegundos O erro mais frequente. O Date.getTime() do JavaScript retorna milissegundos, enquanto o time.time() do Python retorna segundos. Sempre verifique qual unidade sua ferramenta espera — um número de 13 dígitos significa milissegundos.

2. Ignorar fusos horários Unix timestamps estão sempre em UTC. Se você exibir um timestamp sem especificar fuso horário, ele será exibido em UTC por padrão. Use as funções de localização da sua linguagem para converter para o horário local.

3. O problema do ano 2038 Em 19 de janeiro de 2038, timestamps com sinal de 32 bits vão transbordar (2.147.483.647 é o valor máximo). A maioria dos sistemas modernos usa inteiros de 64 bits, então não é um problema prático — mas vale saber se você trabalha com sistemas legados.

4. Esquecer os segundos intercalares Unix timestamps ignoram segundos intercalares. Cada dia é tratado como exatamente 86.400 segundos. Para a maioria das aplicações, isso não importa, mas sistemas de alta precisão precisam considerar isso.

Experimente nosso conversor gratuito

Precisa converter rapidamente um timestamp em data — ou vice-versa? Nosso Conversor de Unix Timestamp handle ambas as direções instantaneamente. Insira um valor, obtenha seu resultado e copie com um clique.

É perfeito para depurar respostas de API, verificar entradas de banco de dados ou converter timestamps de arquivos de log. Consulte também nosso guia O que é um Timestamp? para mais informações.

Perguntas frequentes

O que é um Unix timestamp? Um Unix timestamp é o número de segundos decorridos desde 1º de janeiro de 1970 (o epoch Unix). É uma forma universal e independente de fuso horário de representar qualquer momento como um único inteiro.

Como obtenho o Unix timestamp atual? Em JavaScript: Math.floor(Date.now() / 1000). Em Python: int(time.time()). Em PHP: time(). Todos retornam os segundos atuais desde o epoch.

Por que o JavaScript usa milissegundos? O objeto Date do JavaScript foi projetado para precisão em milissegundos, útil para aplicações web. Multiplique segundos por 1.000 ou divida milissegundos por 1.000 para converter.

Unix timestamps são afetados por fusos horários? Não. Timestamps estão sempre em UTC. Fusos horários só importam quando você converte um timestamp em uma data legível para exibição.

O que acontece depois do ano 2038? Timestamps com sinal de 32 bits transbordam em 19 de janeiro de 2038. Sistemas modernos de 64 bits podem representar datas por bilhões de anos, então não é um problema prático para o software atual.

Como converto milissegundos em segundos? Divida por 1.000. Por exemplo, 1700000000000 milissegundos equivalem a 1700000000 segundos.

Conclusão

Unix timestamps são um conceito fundamental na computação. Eles oferecem uma forma simples e universal de representar o tempo que funciona em todas as linguagens, plataformas e bancos de dados. Seja convertendo timestamps em código, depurando arquivos de log ou apenas por curiosidade sobre o que 1700000000 significa, entender a hora epoch é uma habilidade essencial para qualquer desenvolvedor.

Salve nos favoritos nosso Conversor de Unix Timestamp para conversões rápidas, e confira a Calculadora de diferença de datas e a Calculadora de idade para mais ferramentas relacionadas a datas.