Como Converter Entre Formatos de Hora

Os formatos de hora variam entre sistemas, APIs e países. Timestamps Unix em respostas de APIs, ISO 8601 em bancos de dados, formato 12h nos EUA, formato 24h na Europa — converter entre eles é uma necessidade constante para desenvolvedores e qualquer pessoa que trabalha com dados internacionais.

Formatos comuns de hora

Referência rápida de conversão

12 horas para 24 horas

Timestamps para datas

Use o conversor de época para traduzir timestamps Unix em datas legíveis instantaneamente, e vice-versa. O conversor lida com os formatos em segundos e milissegundos automaticamente.

Exemplos de conversão em código

A maioria dos desenvolvedores acaba precisando converter timestamps em código. As APIs principais são curtas:

• JavaScript — new Date(1712502600 * 1000).toISOString() retorna 2024-04-07T14:30:00.000Z. Lembre-se de multiplicar por 1000, porque o Date do JavaScript espera milissegundos.
• Python — datetime.utcfromtimestamp(1712502600).isoformat() retorna 2024-04-07T14:30:00. Use datetime.fromtimestamp(ts, tz=timezone.utc) para objetos com fuso horário.
• Shell — date -u -d @1712502600 +"%Y-%m-%dT%H:%M:%SZ" no Linux, ou date -u -r 1712502600 +"%Y-%m-%dT%H:%M:%SZ" no macOS.

Armadilhas comuns a evitar

• Esquecer o fuso horário — "2026-04-07 14:30" é ambíguo sem um fuso. Sempre inclua Z ou um deslocamento +00:00 ao armazenar strings ISO.
• Misturar segundos e milissegundos — um timestamp de 10 dígitos está em segundos; um de 13 dígitos, em milissegundos. Misturar os dois produz datas em 1970 ou lá no futuro.
• Depender da hora local no servidor — se seu servidor está em UTC e seu usuário em Tóquio, armazene em UTC e converta apenas na exibição. Deixar o servidor inferir o local quase sempre causa bugs quando os usuários viajam ou o horário de verão muda.
• Fazer parse com manipulação de string — não recorte e concatene strings de data. Use Date.parse(), dateutil.parser ou uma biblioteca dedicada.

Dicas

• Use ISO 8601 ao trocar dados — é inequívoco, ordena corretamente como string e é o padrão para APIs JSON.
• Armazene horas em UTC — converta para a hora local apenas na exibição. Isso evita bugs de fuso horário quando os usuários estão em regiões diferentes.
• Lembre que o JavaScript usa milissegundos — Date.now() retorna milissegundos, não segundos. Divida por 1000 para obter um timestamp Unix padrão.
• Guarde o conversor nos favoritos — se você trabalha com APIs ou logs, converter timestamps é algo que você fará com frequência.