Ler timestamps em logs entre fusos horários

Compare timestamps Unix, strings ISO, logs UTC e horário local sem perder a linha do tempo do incidente.

Linhas do tempo de incidentes cruzam sistemas, regiões e formatos de log. Um serviço grava segundos Unix, outro ISO 8601 em UTC, um dashboard mostra horário local do navegador e o cliente relata no fuso dele.

O truque não é memorizar cada formato. É normalizar antes de comparar.

Formatos comuns

Você verá com frequência:

  • Segundos Unix, como 1716657600.
  • Milissegundos Unix, como 1716657600000.
  • ISO 8601 UTC, como 2026-05-26T06:30:00Z.
  • ISO com offset, como 2026-05-26T14:30:00+08:00.
  • Rótulos locais de dashboard sem offset explícito.

O caso perigoso é o último. Horário sem fuso só faz sentido se você souber qual sistema renderizou.

Segundos vs milissegundos

Segundos Unix têm cerca de 10 dígitos nas datas atuais. Milissegundos têm 13. Misturar unidades gera datas décadas distantes do evento real.

Se o timestamp parece 1970 ou muito no futuro, confira a unidade primeiro. O Conversor de timestamp mostra segundos, milissegundos, horário local e UTC lado a lado.

Normalize para UTC na linha do tempo

Ao reconstruir um incidente, escreva a linha do tempo em UTC primeiro. UTC dá o mesmo ponto de referência a todos os sistemas.

Depois acrescente horário local só quando ajudar leitura humana:

  • Horário do relato do cliente no fuso dele.
  • Horário do ticket no fuso do agente.
  • Horário do dashboard se ele renderiza horário local do navegador.

A análise fica estável mesmo com pessoas em regiões diferentes.

Atenção a atrasos de ingestão

Timestamps de log podem significar coisas diferentes:

  • Quando o evento ocorreu.
  • Quando o serviço escreveu a linha.
  • Quando o coletor recebeu.
  • Quando o índice tornou pesquisável.

Se dois sistemas parecem fora de ordem, verifique se um timestamp é de evento e outro de ingestão.

Fluxo simples de comparação

Para cada linha suspeita:

  1. Copie o timestamp.
  2. Converta para UTC e horário local.
  3. Anote fuso ou unidade original.
  4. Compare valores normalizados em UTC.
  5. Só então decida qual evento veio primeiro.

Bugs de tempo parecem escorregadios porque cada sistema conta uma história ligeiramente diferente. Normalize os timestamps e a história fica bem mais legível.

Ferramentas relacionadas

Use as ferramentas deste artigo

Conversor de Timestamptimestamp / unix / epochFormatador JSONjson / formatter / validator

Aprenda o formato

Curso de Unix time e timestampsAprenda epoch Unix, segundos vs milissegundos, UTC, fusos, ISO 8601 e depuração em logs e APIs.Curso de JSONIntrodução estruturada ao JSON: sintaxe, tipos, parse, geração, padrões reais e trade-offs no ecossistema.

Voltar aos artigos