Como converter timestamp Unix para data corretamente

Converta epoch para data legível sem erros de fuso horário e unidade.

Converta o carimbo de data / hora Unix online: época até a data sem confusão de fuso horário

Os carimbos de data/hora Unix são fáceis para sistemas e difíceis para humanos. As equipes muitas vezes interpretam mal os segundos versus milissegundos, aplicam o fuso horário errado ou comparam valores de ambientes diferentes e presumem que os dados estão errados. Na maioria dos casos, o problema não é o carimbo de data/hora em si. A questão é a interpretação.

Este guia fornece um método confiável para converter valores de época em datas legíveis e anteriores, com verificações práticas de fuso horário e incompatibilidades de unidades. Ele foi projetado para equipes de suporte, desenvolvedores, analistas e fluxos de trabalho de operações que precisam de interpretação de tempo rápida e precisa.

Você também verá exemplos de cargas de API, logs e depuração de eventos para poder resolver discrepâncias com mais rapidez.

Quando usar

Use este guia quando:

  • Você recebe valores brutos de época em logs, APIs ou exportações.
  • Um carimbo de data/hora parece estar "desligado por horas" em todos os sistemas.
  • Você precisa comparar a ordem dos eventos de várias fontes de dados.
  • Você está convertendo dados de programação entre a hora local e UTC.
  • Você precisa de uma conversão segura baseada em navegador para diagnósticos rápidos.

Passo a passo

1. Detecte a unidade primeiro: segundos (10 dígitos) ou milissegundos (13 dígitos). A conversão com a unidade errada cria datas dramaticamente incorretas.

2. Converta o valor para UTC e registre o resultado antes de aplicar visualizações de fuso horário local. UTC é sua linha de base neutra.

3. Aplique o fuso horário alvo para interpretação voltada ao usuário, relatórios ou comunicação com as partes interessadas.

4. Verifique os limites do calendário, como transições de horário de verão, finais de mês e anos bissextos para eventos críticos.

5. Se necessário, converta a data final de volta para a época e compare com a fonte para confirmar a precisão do percurso de ida e volta.

6. Salve suposições de conversão em tickets ou registros para que outros possam reproduzir o mesmo resultado.

Exemplos

Exemplo 1: carimbo de data/hora em segundos dos logs da API

Entrada:

1719830400

Saída:

UTC: 2024-07-01 00:00:00
America/Sao_Paulo: 2024-06-30 21:00:00

Por que é importante: um carimbo de data/hora pode representar horários locais diferentes e, ao mesmo tempo, estar correto.

Exemplo 2: carimbo de data/hora em milissegundos da telemetria de front-end

Entrada:

1719830400000

Saída:

UTC: 2024-07-01 00:00:00

Por que é importante: a eliminação incorreta de três dígitos mudaria a data interpretada em décadas.

Exemplo 3: conversão de data em carimbo de data/hora para agendamento

Entrada:

Date: 2026-02-14 10:30:00 UTC

Saída:

Epoch seconds: 1771065000
Epoch milliseconds: 1771065000000

Por que é importante: os contratos de API geralmente exigem um formato, e o envio do formato errado interrompe a lógica de agendamento.

Erros comuns

  • Tratar milissegundos como segundos ou o contrário.
  • Comparar a hora local de um sistema com o UTC de outro.
  • Ignorando transições para horário de verão em relatórios regionais.
  • Convertendo strings de exibição sem especificar fuso horário.
  • Supondo que o fuso horário do servidor corresponda ao fuso horário do usuário.
  • Arredondando valores prematuramente quando a precisão é importante.
  • Compartilhando datas convertidas sem indicar rótulo de fuso horário.

Ferramentas recomendadas da ToolzFlow

Notas de privacidade (no navegador (sem upload))

A depuração de carimbo de data/hora pode expor logs de eventos vinculados a usuários, transações, ações de segurança e operações internas. A execução de etapas de conversão no navegador ajuda a reduzir a exposição desnecessária durante a triagem e mantém as investigações rápidas independentes.

O processamento local ainda faz parte de uma cadeia maior de tratamento de dados. Exportações, linhas copiadas e capturas de tela compartilhadas podem incluir identificadores que não devem sair de ambientes controlados. Oculte IDs de contas e números de referência antes de compartilhar exemplos fora de canais restritos.

Para equipes que lidam com dados regulamentados, combine a conversão no navegador com limites de retenção e procedimentos fáceis de auditar. A ferramenta de conversão é apenas um componente; a governação em torno de dados de amostra continua a ser essencial.

Perguntas frequentes

Como posso saber se um carimbo de data/hora é milissegundos?

Uma regra prática é o comprimento dos dígitos: 13 dígitos geralmente indicam milissegundos, enquanto 10 dígitos geralmente indicam segundos.

Por que o mesmo carimbo de data/hora mostra horários diferentes?

Porque os fusos horários alteram a representação legível por humanos. O valor da época subjacente permanece o mesmo.

Devo armazenar carimbos de data/hora em UTC?

Sim, armazenar em UTC geralmente é mais seguro. Converta para fuso horário local apenas para apresentação.

E quanto ao horário de verão?

Sempre use a conversão explícita de fuso horário e verifique as datas limite em torno das alterações do horário de verão.

Resumo

  • Confirme as unidades antes da conversão.
  • Use o UTC como linha de base e aplique o fuso horário desejado.
  • Valide a conversão de ida e volta para fluxos de trabalho críticos.
  • Rotule o fuso horário em cada exemplo de carimbo de data/hora compartilhado.
  • Mantenha amostras de eventos confidenciais protegidas durante a depuração.