Convertidor de timestamp Unix

El tiempo Unix cuenta los segundos transcurridos desde las 00:00:00 UTC del 1 de enero de 1970, sin tener en cuenta los segundos intercalares. Es el formato de la mayoría de las líneas de log, fechas de caducidad de tokens, columnas de base de datos y campos de API, y resulta ilegible si no lo conviertes. Esta herramienta pasa de un timestamp a una fecha y viceversa, y muestra el resultado a la vez en tu zona horaria local, en UTC y en ISO 8601.

Cómo funciona

En el modo Timestamp → Fecha, introduce un número e indica si está en segundos o en milisegundos. La herramienta multiplica los segundos por 1000, crea un objeto Date de JavaScript y muestra tres representaciones: la fecha y la hora locales de tu navegador, el mismo instante en UTC y la cadena ISO 8601 terminada en Z. El botón Copiar lleva la forma ISO al portapapeles, porque es la que otros sistemas interpretan sin ambigüedad. Usar ahora rellena la hora actual en la unidad seleccionada.

En el modo Fecha → Timestamp, elige una fecha y una hora con el selector del navegador. El valor se interpreta en tu zona horaria local, se convierte a milisegundos desde el epoch y se muestra tanto en segundos enteros (redondeados hacia abajo) como en milisegundos.

Todo se ejecuta en local. La representación local depende de la zona horaria de tu dispositivo, así que dos personas que conviertan el mismo número pueden ver horas distintas; las líneas UTC e ISO son iguales para todo el mundo.

Segundos, milisegundos y más allá

Para cualquier fecha de la era actual, un número de diez dígitos está en segundos y uno de trece dígitos, en milisegundos. Si la fecha convertida cae en 1970 o en un futuro lejano, casi seguro que has elegido la unidad equivocada. System.currentTimeMillis() en Java, Date.now() en JavaScript y la mayoría de las API JSON usan milisegundos; las herramientas POSIX, los claims de JWT y muchas bases de datos usan segundos.

Los valores de dieciséis dígitos son microsegundos y los de diecinueve, nanosegundos, que emiten algunos sistemas de tracing y de métricas. La herramienta no ofrece esas unidades: divide antes entre 1000 o entre 1 000 000. Se aceptan fracciones de segundo en la entrada, y aparecen en la salida ISO con precisión de milisegundo, que es la precisión de un Date de JavaScript.

Los timestamps negativos son válidos y representan fechas anteriores a 1970. El rango representable abarca unos ±273 000 años alrededor del epoch, mucho más de lo que necesitará cualquier dato real.

Zonas horarias y horario de verano

Un timestamp Unix no tiene zona horaria: identifica un instante. La zona solo importa cuando conviertes ese instante en una fecha del calendario, y por eso la herramienta muestra la hora local y la UTC una al lado de la otra. Cuando una entrada de log parece desfasada una hora, lo habitual es que quien la escribió usara la hora local y quien la lee diera por hecho que era UTC, o que entre ambos momentos hubiera un cambio de horario de verano.

La ambigüedad aparece en el sentido fecha → timestamp. Durante la hora que se repite cuando se atrasan los relojes, una misma hora local corresponde a dos instantes, y el navegador elige uno. Si necesitas precisión a ese nivel, trabaja en UTC y convierte con una biblioteca adecuada en lugar de con un selector de fecha.

Equivalente en la línea de comandos

El comando date de GNU convierte en ambos sentidos:

date -u -d @1700000000              # Tue Nov 14 22:13:20 UTC 2023
date +%s                            # current Unix time in seconds
date -d '2024-03-01T09:00:00Z' +%s  # ISO string to seconds

En macOS, la primera forma se escribe date -r 1700000000.

El año 2038

Los sistemas que guardan el tiempo Unix en un entero de 32 bits con signo se desbordan a las 03:14:07 UTC del 19 de enero de 2038. Los sistemas operativos y lenguajes modernos usan 64 bits, pero no ocurre lo mismo con los dispositivos embebidos, los formatos de archivo antiguos ni algunos esquemas de base de datos. Si estás diseñando hoy cómo almacenarlo, usa un entero de 64 bits o un tipo timestamp de verdad.

Para saber más

El paquete java.time de Java modela esta distinción de forma directa: Instant es el timestamp, ZonedDateTime es el instante más una zona y LocalDateTime es una hora de reloj sin ninguna zona. La guía sobre Optional y la API java.time explica cuál usar en cada caso y cómo convertir entre ellos de forma segura. Los claims exp e iat que ves en el decodificador de JWT son segundos Unix, y la calculadora de edad se encarga de la aritmética de calendario cuando ya tienes una fecha.