Entender marcas de tiempo Unix y cómo convertirlas
Por qué importa el tiempo epoch, la trampa segundo‑vs‑milisegundo que sigue mordiendo a ingenieros y cómo convertir cualquier marca a fecha legible en cualquier zona horaria.
Más utilidades que combinan bien con esta guía:
Por qué importa
Un ingeniero de logging investiga por qué saltó una alerta en «1735689600». ¿Es 2025‑01‑01 00:00:00 UTC en segundos o 1970‑01‑21 02:08:09 si milisegundos se interpretan como segundos? Elegir mal desplaza la línea de tiempo del postmortem 55 años. Las marcas Unix son excelentes para almacenamiento y aritmética pero malas para humanos, y la convención segundo‑vs‑milisegundo varía entre lenguajes, bases de datos y APIs. Un convertidor fiable hace la elección explícita.
Tres escenarios reales
Pega 1735689600, el convertidor muestra 2025-01-01 00:00:00 UTC y 2024-12-31 16:00:00 PST. Elige la zona del usuario afectado y sigue.
Triage de incidente más rápido
Escribe la fecha local en JST, copia la marca resultante en segundos o milisegundos según tu planificador.
Epoch correcto en código
Pega una lista de valores epoch, ve las fechas UTC decodificadas junto a ellas, copia el resultado de vuelta a la hoja.
Informe legible
Guía paso a paso
Abre el convertidor de marca de tiempo Unix.
Pega una marca o elige fecha
El convertidor detecta si el valor está en segundos (~10 dígitos, ~1973–2286) o milisegundos (13 dígitos) automáticamente. Sobrescribe con el desplegable si tu valor es inusual.
Lee la fecha decodificada en varias zonas
UTC, la zona local del navegador y cualquier zona IANA personalizada (p. ej.
Asia/Tokyo,America/Sao_Paulo).Convierte en la dirección opuesta
Escribe fecha y hora en cualquier zona; el convertidor muestra la marca epoch en segundos y milisegundos.
Copia en el formato que necesites
1735689600,1735689600000, ISO2025-01-01T00:00:00Z, RFC 2822 — elige lo que acepte tu destino.
Entrada
1735689600 (seconds)Decodificado
UTC: 2025-01-01 00:00:00
ISO: 2025-01-01T00:00:00.000Z
Local: 2024-12-31 19:00:00 (UTC-5)Entrada
1735689600 (mistakenly read as milliseconds)Decodificado como ms
UTC: 1970-01-21 02:08:09.600
Consejos útiles
- Incluye siempre la unidad en tus contratos API. «Envíame marca Unix» es ambiguo; «entero Unix en milisegundos» no lo es.
- Trata marcas negativas como válidas para fechas antes de 1970‑01‑01 — el convertidor las acepta y muestra la fecha gregoriana correcta.
- Usa ISO‑8601 para pantallas humanas.
2026-04-22T15:30:00Zes inequívoca y ordenable léxicamente. - Convierte por lotes una columna de marcas pegando cada una en su propia línea.
Trampas comunes
Error frecuente
Sorpresas de horario de verano tras conversión de zona
Una reunión a las 09:00 Pacífico en octubre ≠ 09:00 Pacífico en noviembre porque PDT pasa a PST. Convierte con zona IANA (America/Los_Angeles), no con desfase fijo (UTC-8), y el convertidor maneja el horario de verano.
Error frecuente
Date.getTime() de JavaScript vs time.time() de Python
JS devuelve milisegundos; Python segundos con componente fraccionario. Al portar código, multiplica o divide por 1000 explícitamente. El convertidor acepta ambos formatos para detectar el desajuste.
Error frecuente
Problema del año 2038
Algunos sistemas legacy guardan tiempo Unix en entero con signo de 32 bits. Cualquier valor tras 2147483647 (2038‑01‑19) desborda. Si mantienes tal sistema, planifica migración a tiempo de 64 bits.
Cuándo no es la herramienta adecuada
- Aritmética de días hábiles (p. ej. «5 días laborables desde ahora»). Usa una librería tipo
date-fns-business-dayso el calendario festivo de tu sistema contable. - Depuración de cron se hace mejor con un evaluador de expresiones cron que emita las próximas N ejecuciones.
- Eventos recurrentes conscientes de calendario (RRULE) pertenecen a parsers iCalendar, no a un convertidor plano de segundos.
Preguntas frecuentes
¿En qué zona está el «cero epoch»?
0 es 1970-01-01 00:00:00 UTC. UTC está implícita en la definición del epoch Unix.
¿Por qué las fechas saltan una hora dos veces al año?
Es el horario de verano. La base de datos de zonas IANA lleva las reglas DST de cada región y el convertidor las aplica automáticamente.
¿Se envía mi entrada a un servidor?
No. La conversión usa Date e Intl.DateTimeFormat del navegador; nada sale de la página.
Próximos pasos
- Traza ventanas de reunión entre equipos con la herramienta Comparar zonas horarias.
- Añade un reloj mundial personal para tus ciudades más usadas en /time-tools/world-clock.
- Consulta festivos de hoy en la región afectada con Festivos de hoy.