Entendendo timestamps Unix
Os timestamps Unix parecem simples porque são apenas números, mas aparecem em praticamente todo trabalho na web. APIs, logs, exportações, mensagens de fila e registros de eventos dependem deles. O formato é apenas um inteiro contando segundos (ou milissegundos) desde 1º de janeiro de 1970 UTC.
A vantagem é a consistência. Um timestamp é compacto, neutro em relação ao fuso no nível de armazenamento e fácil para o software comparar, ordenar ou transmitir. O desafio é que o formato não é legível por si só: um valor como 1710153600 não diz nada até ser convertido em data.
Por isso as ferramentas de timestamp continuam úteis até para devs experientes. Muitas vezes é preciso responder perguntas práticas rápidas: este valor está em segundos ou milissegundos? Que data ele representa em UTC e na hora local? Que timestamp corresponde a uma data específica para uma requisição de teste?
Quando isso é útil
- Revisar respostas de API que devolvem campos numéricos de tempo como
created_atouexpires_at. - Verificar logs em que os horários de eventos são armazenados como valores Unix crus.
- Depurar questões de fuso horário entre um serviço de backend e o navegador.
- Converter uma data humana em tempo Unix antes de testar uma requisição ou payload.
Exemplo prático
Imagine que uma API envia 1710153600 em um payload JSON. À primeira vista esse número não diz muito, mas ao converter percebe-se que ele corresponde a uma data UTC específica e a uma data local no seu fuso. Isso responde na hora se o valor é plausível ou se está desviado por horas, dias ou até num erro de escala de mil vezes.
Aqui também os milissegundos importam. Um valor como 1710153600000 representa o mesmo instante, mas em milissegundos em vez de segundos. Se tratar um como o outro, sua data ficará completamente errada.
Casos de uso comuns
- Verificar se um campo de timestamp em um payload usa segundos ou milissegundos.
- Comparar o horário de um evento em UTC com o que os usuários veem na hora local.
- Criar valores de expiração de exemplo para testes e demonstrações.
- Verificar se o código de backend e o de frontend estão convertendo do mesmo jeito.
- Ler dados exportados antigos sem abrir um console ou script separado.
Use o conversor no navegador
Use a ferramenta no navegador para aplicar isso em segundos.
Perguntas frequentes
Por que os timestamps usam UTC?
O UTC dá ao software um ponto de referência estável. A versão local legível pode mudar conforme o fuso, mas o timestamp armazenado não.
Por que alguns timestamps têm 10 dígitos e outros 13?
Dez dígitos geralmente significam segundos. Treze dígitos geralmente significam milissegundos.
Eu sempre preciso de UTC e hora local?
Geralmente sim, quando você está depurando. O UTC ajuda a comparar sistemas, e a hora local ajuda a conferir o que o usuário realmente viu.