Os timestamps Unix são perfeitos para máquinas e inúteis para humanos. Todo agregador de logs, registro de banco de dados e resposta de API parece armazenar o tempo como um número inteiro bruto contando segundos desde 1º de janeiro de 1970, e todo desenvolvedor já tentou, em algum momento, adivinhar de relance se 1725580800 é recente ou antigo.
O recurso habitual é uma busca rápida no Google — "1725580800 to date" — que funciona, mas adiciona uma ida e volta ao navegador para algo que deveria ser uma consulta de dois segundos. Ou você escreve uma linha em um console de linguagem: new Date(1725580800000) no console JS do navegador, lembrando de multiplicar por 1000 para milissegundos e torcendo para não ter confundido segundos com milissegundos desde o início.
Segundos vs. Milissegundos: A Armadilha Clássica
O tempo Unix normalmente é em segundos, mas o objeto Date do JavaScript espera milissegundos, e algumas APIs (especialmente as construídas em JavaScript) retornam timestamps em milissegundos por padrão. Confundir isso resulta em uma data que está muito no futuro ou presa perto da época de 1970 — um erro que todo desenvolvedor já cometeu pelo menos uma vez ao depurar um problema de "por que essa data parece errada".
Os fusos horários adicionam outra camada. Um timestamp converte para um instante específico, mas exibi-lo no seu horário local versus UTC versus o fuso horário do servidor pode fazer o mesmo valor parecer três horas completamente diferentes, o que importa muito quando você está tentando correlacionar um erro com uma implantação.
Converta em Ambas as Direções Instantaneamente
Bellows inclui um conversor de timestamp que transforma um timestamp Unix em uma data e hora legíveis, e converte uma data de volta em timestamp — ambas as direções, sem necessidade de cálculo. Ele lida com a ambiguidade entre segundos e milissegundos para que você não precise adivinhar.
Depurando Logs e Bancos de Dados
Agregadores de log, linhas de banco de dados e payloads de API armazenam o tempo como números brutos com muito mais frequência do que como strings legíveis. Converter um punhado de timestamps enquanto rastreia um incidente é uma pequena tarefa que acontece dezenas de vezes em qualquer sessão séria de depuração.
Agendamento e Lógica de Expiração
Expiração de cache, expiração de token e timestamps de tarefas agendadas são todos tempo Unix por baixo dos panos. Verificar rapidamente a que um determinado valor de expiração realmente corresponde no relógio real ajuda a confirmar que sua lógica de TTL está fazendo o que você pensa que está fazendo.