O idioma universal das datas
Formatos de data humanos brigam entre si — 07/01/2026 é 7 de janeiro no Brasil e 1º de julho nos Estados Unidos. O timestamp resolve isso na raiz: um número único, sem fuso, sem separador, sem ambiguidade, contando os segundos passados desde 1º de janeiro de 1970 às 00:00 UTC. Bancos de dados, logs de servidor, tokens JWT (campos iat e exp) e praticamente toda API falam epoch por baixo dos panos.
A grande vantagem prática vem da aritmética: subtrair dois timestamps dá a diferença em segundos, direto, sem se preocupar com meses de tamanhos diferentes, ano bissexto ou virada de ano. "Quanto tempo esse pedido ficou parado?" é uma subtração, e não um algoritmo de calendário.
Segundos, milissegundos e o resto
A confusão mais frequente é de escala. O padrão Unix conta em segundos, mas cada ecossistema escolheu a sua unidade, e o número de dígitos entrega qual é:
| Dígitos | Unidade | Exemplo | Onde aparece |
|---|---|---|---|
| 10 | Segundos | 1700000000 | Unix, PHP, MySQL, JWT, APIs REST |
| 13 | Milissegundos | 1700000000000 | JavaScript, Java, Kotlin, Android |
| 16 | Microssegundos | 1700000000000000 | PostgreSQL interno, Python |
| 19 | Nanossegundos | 1700000000000000000 | Go, métricas de observabilidade |
Marcos para conferir de olho
Guardar dois ou três pontos de referência permite avaliar um timestamp sem converter: se o número começa com 17, é 2023 ou 2024; começando com 18, já é 2027 em diante.
| Timestamp | Data em UTC |
|---|---|
| 0 | 01/01/1970 00:00:00 — o epoch |
| 1000000000 | 09/09/2001 01:46:40 |
| 1234567890 | 13/02/2009 23:31:30 |
| 1500000000 | 14/07/2017 02:40:00 |
| 1700000000 | 14/11/2023 22:13:20 |
| 2000000000 | 18/05/2033 03:33:20 |
| 2147483647 | 19/01/2038 03:14:07 — o limite dos 32 bits |
Fuso horário: onde o Brasil entra na conta
O timestamp em si não tem fuso — ele é contado em UTC. O fuso aparece só na hora de exibir, e é aí que nascem as discussões de "o log está com a hora errada". Brasília trabalha em UTC−3, então 15:00 UTC é 12:00 em Brasília.
| Região | Diferença para o UTC | Exemplo: 15:00 UTC |
|---|---|---|
| Brasília, São Paulo, Salvador, Belém | UTC−3 | 12:00 |
| Manaus, Cuiabá, Porto Velho, Boa Vista | UTC−4 | 11:00 |
| Rio Branco e oeste do Amazonas | UTC−5 | 10:00 |
| Fernando de Noronha | UTC−2 | 13:00 |
Como obter o timestamp em cada ferramenta
A fórmula do Excel merece explicação: 86.400 é o número de segundos de um dia e 25.569 é a distância em dias entre a data zero da planilha (30/12/1899) e o epoch de 1970. O resultado sai em UTC — para o horário de Brasília, subtraia 3/24 e formate a célula como data e hora.
| Ferramenta | Timestamp atual | Converter para data |
|---|---|---|
| JavaScript | Math.floor(Date.now()/1000) | new Date(ts*1000) |
| Python | int(time.time()) | datetime.fromtimestamp(ts) |
| PHP | time() | date('d/m/Y H:i', $ts) |
| MySQL | UNIX_TIMESTAMP() | FROM_UNIXTIME(ts) |
| PostgreSQL | extract(epoch from now()) | to_timestamp(ts) |
| Linux e macOS | date +%s | date -r ts |
| Excel | — | =A1/86400+25569 |
Perguntas frequentes
O que é um timestamp Unix?
É o número de segundos decorridos desde 1º de janeiro de 1970 às 00:00 UTC (o "epoch"). É o formato universal de data em bancos de dados, logs e APIs.
Como saber se o timestamp está em segundos ou milissegundos?
Pelo tamanho: 10 dígitos = segundos, 13 dígitos = milissegundos. Esta ferramenta detecta automaticamente e mostra os dois.
O que acontece em 2038?
Sistemas antigos que guardam o timestamp em inteiro de 32 bits estouram em 19/01/2038. Sistemas modernos usam 64 bits e estão tranquilos por 292 bilhões de anos.
Qual é o fuso do Brasil em relação ao timestamp?
O timestamp não tem fuso: ele conta segundos em UTC. Brasília está em UTC−3, então uma data mostrada como 12h em Brasília corresponde a 15h UTC. O país tem ainda UTC−4 (Amazonas, Mato Grosso, Rondônia, Roraima), UTC−5 (Acre e o oeste do Amazonas) e UTC−2 em Fernando de Noronha.
O timestamp muda com o horário de verão?
Não. O timestamp é sempre contado em UTC, que não tem horário de verão — o que muda é apenas a conversão para a hora local. No Brasil o horário de verão foi extinto em 2019, então datas anteriores a 2019 no verão do Sudeste e do Sul convertem com UTC−2, e não com UTC−3.
Timestamp pode ser negativo?
Sim: valores negativos representam datas anteriores a 1º de janeiro de 1970. Uma pessoa nascida em 1965 tem timestamp de nascimento negativo. O padrão aceita isso, mas muitos sistemas e bancos de dados rejeitam ou calculam errado — por isso datas de nascimento costumam ser guardadas como DATE, e não como epoch.
Como converter timestamp Unix no Excel?
Use =A1/86400+25569 e formate a célula como data e hora. O 86400 é o número de segundos de um dia e o 25569 é a diferença em dias entre a data zero do Excel (30/12/1899) e o epoch de 1970. O resultado sai em UTC; para o horário de Brasília, subtraia 3/24.
Por que a data convertida aparece diferente para mim e para o meu colega?
Porque a linha "local" usa o fuso configurado em cada computador. O mesmo timestamp visto em Brasília e em Rio Branco mostra horas diferentes, ainda que seja exatamente o mesmo instante. Ao comparar registros entre times ou servidores, use sempre a linha UTC.