Fecha a epoch: convierte una hora en timestamp Unix o tiempo epoch
Aprende a convertir una fecha y hora humanas en tiempo epoch, segundos de timestamp Unix, milisegundos de timestamp Unix o salida ISO. Cubre la selección de zona horaria, la conversión a UTC, los payloads de API y los errores comunes.
Qué significa convertir fecha a epoch
Convertir fecha a epoch toma una fecha legible, una hora y una zona horaria, y devuelve un timestamp numérico. El resultado numérico representa un único instante en todas partes. Por ejemplo, 2026-01-01 00:00:00 UTC se convierte en los segundos Unix 1767225600.
La zona horaria forma parte de la entrada
Una hora local como 2026-01-01 00:00 está incompleta sin zona horaria. La medianoche en UTC, Nueva York, Los Ángeles, Londres y Tokio son instantes distintos y, por tanto, timestamps epoch distintos. Elige siempre la zona horaria antes de convertir la hora a 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 o milisegundos?
Tras convertir una fecha a epoch, elige la unidad que requiera el sistema de destino. Las APIs de backend, los comandos de Linux, PHP, Python, Go y muchas funciones SQL suelen usar segundos Unix. JavaScript Date, las APIs del navegador y muchos payloads de analítica suelen usar milisegundos Unix.
- Segundos Unix: 1767225600
- Milisegundos Unix: 1767225600000
- JavaScript: new Date('2026-01-01T00:00:00Z').getTime() devuelve milisegundos
- JavaScript segundos: Math.floor(new Date('2026-01-01T00:00:00Z').getTime() / 1000)
- SQL suele aceptar segundos mediante to_timestamp() o FROM_UNIXTIME()
Dónde se usa la conversión de fecha a epoch
Convertir fecha a epoch es útil siempre que un sistema quiera un límite de tiempo numérico en vez de una cadena de fecha formateada.
- Pruebas de API que necesitan valores expires_at o starts_at
- Migraciones de base de datos que rellenan columnas de timestamp
- Consultas de analítica que necesitan límites epoch de inicio y fin
- Tareas de cron, programación y colas que guardan tiempos de ejecución de forma numérica
- URLs y tokens firmados con timestamps de caducidad
Preguntas frecuentes sobre fecha a epoch
- ¿Cómo convierto la hora a tiempo epoch?
- Elige la fecha, la hora y la zona horaria, y convierte ese instante a segundos o milisegundos Unix. Si falta la zona horaria, el resultado puede desviarse unas horas.
- ¿Es lo mismo timestamp a epoch que fecha a epoch?
- Normalmente sí. Significa convertir un timestamp legible o una cadena de fecha y hora en un número epoch.
- ¿Debo enviar segundos o milisegundos epoch a una API?
- Sigue la documentación de la API. Si dice timestamp Unix, suele significar segundos, pero las APIs orientadas a JavaScript pueden esperar milisegundos.
- ¿Por qué la misma fecha da un epoch distinto en zonas horarias distintas?
- Porque una hora local de reloj solo identifica un instante cuando se le añade una zona horaria. 2026-01-01 00:00 es 1767225600 en UTC, pero 1767243600 en Nueva York: cinco horas más tarde en tiempo real. Fija la zona horaria antes de convertir.