Blog

Converta timestamps Unix no Mac sem confundir unidades ou fusos horários

Confira primeiro a unidade, compare UTC com a hora local e copie a data ou o formato de timestamp esperado pelo destino.

Quando um log ou uma resposta de API contém um timestamp Unix, confira se o valor está em segundos ou milissegundos antes de convertê-lo. Depois, verifique o fuso horário usado na leitura. No Frset, a ferramenta Timestamp converte timestamps numéricos em datas e datas locais de volta em segundos ou milissegundos.

Separe o instante da forma como ele é exibido

Um timestamp Unix conta o tempo a partir da época Unix. O mesmo instante pode ser exibido de maneiras diferentes em UTC e no fuso horário local do seu Mac. A documentação de data e hora do Python explica a conversão de timestamps e o papel dos fusos horários.

Por exemplo, 1704067200 segundos e 1704067200000 milissegundos representam o mesmo instante: 1º de janeiro de 2024 às 00:00:00 UTC. Em Asia/Shanghai, esse instante corresponde a 1º de janeiro às 08:00:00. Uma diferença de oito horas entre essas exibições não significa que seja preciso adicionar oito horas ao timestamp original.

Converta um timestamp com o Frset

  1. Abra a busca do Frset e escolha Timestamp, usando a palavra-chave padrão /time se ela não tiver sido alterada.
  2. Selecione o modo de conversão de timestamp para data.
  3. Cole apenas o valor numérico, sem nome de campo nem aspas.
  4. Execute a conversão e confira se a unidade detectada é segundos ou milissegundos.
  5. Compare as saídas local e UTC e copie a representação necessária.

As configurações de saída da ferramenta podem incluir hora local, UTC, ISO 8601 e RFC 3339. Se uma representação útil não aparecer, confira quais saídas estão ativadas. Resultados bem-sucedidos são copiados para a área de transferência e adicionados ao histórico.

Nos limites atuais de implementação, o Frset aceita valores de 9 ou 10 dígitos em segundos e de 12 ou 13 dígitos em milissegundos, dentro do intervalo de 1º de janeiro de 2000 a 1º de janeiro de 2100 UTC. Valores negativos, entradas decimais e datas fora desse intervalo não são aceitos por esta ferramenta. Não interprete a rejeição como prova de que os dados de origem são inválidos em todos os sistemas.

Converta uma data local de volta em timestamp

Mude para o modo de conversão de data em timestamp e informe uma data no formato yyyy-MM-dd HH:mm:ss, por exemplo, 2024-01-01 08:00:00. Selecione segundos ou milissegundos como unidade de saída e execute a ferramenta.

A entrada é interpretada no fuso horário atual do Mac. Se o Mac estiver definido como Asia/Shanghai, o exemplo corresponde a 1704067200 segundos. Em outro fuso horário, a mesma data digitada pode representar um instante diferente. Confira o fuso do Mac antes de converter um horário agendado recebido de um colega.

Este campo não é um analisador de datas genérico. Não cole uma data ISO com sufixo Z nem uma data em linguagem natural e suponha que ela será interpretada corretamente. Use o formato exigido e verifique o fuso horário pretendido separadamente.

Confira três pontos quando o resultado parecer incorreto

  • Unidade: Um sistema que espera milissegundos precisa de um valor numérico diferente de um que espera segundos. Confira a documentação da API em vez de confiar apenas na contagem de dígitos.
  • Fuso: Compare a saída UTC com a local antes de editar o número original. Uma diferença na exibição não significa necessariamente erro nos dados.
  • Significado: Confirme se o campo registra criação, atualização, expiração ou um evento agendado. Converter corretamente não revela a finalidade do campo.

Copie apenas o valor esperado pelo destino. Se ele precisa de um número, não cole um bloco de resultado inteiro com rótulos e vários formatos de data. Revise um horário de expiração ou agendado antes de aplicá-lo a um sistema real.

Mantenha a fonte junto da conversão

Ao investigar uma resposta, mantenha o nome do campo, o valor original e a unidade esperada na sua nota de trabalho. O guia de JSON ajuda a deixar a resposta legível, enquanto o histórico da área de transferência permite encontrar a fonte copiada novamente.

A conversão de timestamps é executada localmente e não precisa de um provedor de IA. O uso disponível da ferramenta depende do seu plano Frset; as regras de unidade, intervalo e fuso horário da conversão continuam valendo em qualquer plano.