Timestamp Unix (Epoch Time) Explicado
Un timestamp Unix resume cualquier instante en un solo entero: la cantidad de segundos desde el 1 de enero de 1970 a las 00:00 UTC. Esa simplicidad esconde algunas trampas: unidad, zona horaria y tamaño del entero. Esta guía explica qué significa el número, cómo leerlo y dónde suelen fallar las conversiones.
¿Qué Es Exactamente un Timestamp Unix?
Un timestamp Unix (también llamado epoch time) cuenta los segundos desde 1970-01-01T00:00:00Z, la epoch de Unix. La cuenta se hace en UTC, así que el número es el mismo en cualquier país en el mismo instante. El valor puede ser negativo para momentos anteriores a 1970 y siempre es una duración, nunca una fecha formateada. 1700000000 no es "una hora en Londres"; es un instante absoluto que cada zona horaria muestra de forma distinta.
¿Segundos, Milisegundos o Microsegundos?
El mismo instante se puede escribir con precisiones distintas: segundos (1700000000, 10 dígitos), milisegundos (1700000000000, 13), microsegundos (16) o nanosegundos (19). Date.now() de JavaScript, System.currentTimeMillis() de Java y muchas APIs usan milisegundos; date +%s y la mayoría de las herramientas Unix usan segundos. Cuenta los dígitos como primera comprobación. Pasar segundos a una API de milisegundos fecha el valor en enero de 1970, mientras que pasar milisegundos a una API de segundos lo lleva decenas de miles de años al futuro. Divide o multiplica por 1000 antes de convertir.
¿Por Qué el Mismo Timestamp Muestra Horas Distintas?
El timestamp no depende de la zona horaria; la visualización sí. 1700000000 se muestra como 22:13 UTC del 14 de noviembre de 2023, pero como 19:13 en São Paulo y 23:13 en Madrid. Es el mismo instante, no un error de conversión. Guarda los timestamps en UTC (o como entero) y aplica la zona del usuario solo al formatear. Las cadenas ISO 8601 como 2023-11-14T22:13:20Z dejan la zona explícita y son más fáciles de leer en los logs.
¿Qué Son el Problema de 2038 y los Segundos Bisiestos?
Quedan dos trampas clásicas. El tiempo Unix ignora los segundos bisiestos: cada día se trata como exactamente 86.400 segundos, así que el contador puede quedar un segundo desfasado de UTC tras insertarse un segundo bisiesto. El problema de 2038 es un desbordamiento: los sistemas que guardan el valor en un entero con signo de 32 bits se agotan en 2147483647, que es 2038-01-19T03:14:07Z, y vuelven a 1901. Usa enteros de 64 bits o cadenas ISO 8601 en esquemas nuevos, y comprueba que los dispositivos embebidos y las bases de datos antiguas sobrevivan a esa fecha.
¿Cómo Convertir Timestamps Sin Errores?
Define la unidad antes de guardar el valor, mantén los timestamps en bruto en UTC y convierte solo en los bordes del sistema. Un conversor ayuda a revisar un número sospechoso: pégalo y verás la fecha, la unidad y la cadena ISO una al lado de la otra. Usa el Convertidor de Epoch y Timestamp para convertir segundos, milisegundos y microsegundos en ambos sentidos: todo se ejecuta en tu navegador.