Data para epoch: converter uma hora em timestamp Unix ou tempo epoch
Aprenda a converter uma data e hora humanas em tempo epoch, segundos de timestamp Unix, milissegundos de timestamp Unix ou saída ISO. Cobre a seleção de fuso, a conversão para UTC, os payloads de API e os erros comuns.
O que significa converter data para epoch
Converter data para epoch toma uma data legível, um horário e um fuso, e retorna um timestamp numérico. O resultado numérico representa um único instante em todo lugar. Por exemplo, 2026-01-01 00:00:00 UTC vira os segundos Unix 1767225600.
O fuso faz parte da entrada
Um horário local como 2026-01-01 00:00 fica incompleto sem fuso. Meia-noite em UTC, Nova York, Los Angeles, Londres e Tóquio são instantes diferentes e, portanto, timestamps epoch diferentes. Sempre escolha o fuso antes de converter a hora em timestamp Unix.
- 2026-01-01 00:00 UTC = 1767225600 segundos
- 2026-01-01 00:00 America/New_York = 1767243600 segundos
- 2026-01-01 00:00 America/Los_Angeles = 1767254400 segundos
- 2026-01-01 00:00 Asia/Tokyo = 1767193200 segundos
Segundos ou milissegundos?
Depois de converter uma data para epoch, escolha a unidade exigida pelo sistema de destino. APIs de backend, comandos Linux, PHP, Python, Go e muitas funções SQL costumam usar segundos Unix. JavaScript Date, APIs do navegador e muitos payloads de analytics costumam usar milissegundos Unix.
- Segundos Unix: 1767225600
- Milissegundos Unix: 1767225600000
- JavaScript: new Date('2026-01-01T00:00:00Z').getTime() retorna milissegundos
- JavaScript segundos: Math.floor(new Date('2026-01-01T00:00:00Z').getTime() / 1000)
- SQL costuma aceitar segundos via to_timestamp() ou FROM_UNIXTIME()
Onde a conversão de data para epoch é usada
Converter data para epoch é útil sempre que um sistema quer um limite de tempo numérico em vez de uma string de data formatada.
- Testes de API que precisam de valores expires_at ou starts_at
- Migrações de banco que preenchem colunas de timestamp
- Consultas de analytics que precisam de limites epoch de início e fim
- Jobs de cron, agendamento e filas que guardam horários de execução numericamente
- URLs e tokens assinados com timestamps de expiração
FAQ sobre data para epoch
- Como converto hora em tempo epoch?
- Escolha a data, o horário e o fuso, e converta esse instante em segundos ou milissegundos Unix. Se faltar o fuso, o resultado pode ficar errado por horas.
- Timestamp para epoch é o mesmo que data para epoch?
- Geralmente sim. Significa converter um timestamp legível ou string de data-hora em um número epoch.
- Devo enviar segundos ou milissegundos epoch para uma API?
- Siga a documentação da API. Se ela diz timestamp Unix, geralmente significa segundos, mas APIs voltadas a JavaScript podem esperar milissegundos.
- Por que a mesma data dá um epoch diferente em fusos diferentes?
- Porque uma hora local só identifica um instante quando um fuso é anexado. 2026-01-01 00:00 é 1767225600 em UTC, mas 1767243600 em Nova York — cinco horas depois no tempo real. Defina o fuso antes de converter.