Convertir timestamp a fecha: segundos, milisegundos y UTC

PublicadoHerramientaTimestamp Unix de ahora mismo · segundos y milisegundos

Contenido
  1. En los logs solo aparece el número, sin unidad
  2. Cómo convertir a mano, sin herramienta
  3. Por qué el mismo valor se ve distinto en local, UTC e ISO
  4. El error más común: confundir la unidad desvía el resultado 1000 veces
  5. En resumen
  6. Preguntas frecuentes

Este artículo es para quienes necesitan convertir una marca de tiempo guardada como un número, por ejemplo 1700000000, en una fecha legible. Un timestamp Unix no es más que los segundos o milisegundos transcurridos desde el 1 de enero de 1970 a las 0:00 (UTC), así que conociendo la regla puedes leer con exactitud qué momento representa cualquier número. Y al revés: si te equivocas de unidad, el mismo número puede aparecer como 1970 o como varios miles de años en el futuro.

Resumen ① Un timestamp son los segundos o milisegundos transcurridos desde 1970-01-01 00:00:00 UTC (la época). ② Si tiene 11 dígitos o menos, son segundos; si tiene 12 o más, son milisegundos. Si confundes la unidad, la fecha resultante se desvía unas 1000 veces. ③ Un mismo timestamp se muestra distinto en formato local, UTC e ISO, y la diferencia es exactamente el desplazamiento horario.

En los logs solo aparece el número, sin unidad

En los logs del servidor y en las respuestas de una API es frecuente que la hora quede registrada como un único número, algo como created_at: 1700000000. No guardan un "noviembre de 2023" legible, sino el tiempo transcurrido desde la época tal cual.

El problema es que ese número no lleva escrita la unidad: no dice si son segundos o milisegundos. Unos sistemas registran en segundos y otros en milisegundos, de modo que dos campos con el mismo nombre pueden tener valores con distinta cantidad de dígitos.

Por eso, cuando en un log ves 1700000000 y 1700000000000 uno al lado del otro, no es fácil saber a simple vista si son el mismo instante o dos momentos completamente distintos. Este artículo repasa las reglas para leer ese número como la fecha correcta.

Cómo convertir a mano, sin herramienta

Paso 1: Empezar por la definición de época

El punto de referencia (la época) del timestamp Unix es el 1 de enero de 1970 a las 00:00:00 UTC. Un timestamp es un solo número que indica cuántos segundos (o milisegundos) han pasado desde ese instante.

Lo importante aquí es que la referencia es UTC. El timestamp en sí no contiene información de zona horaria: señala el mismo instante absoluto se lea donde se lea.

Paso 2: Deducir la unidad por la cantidad de dígitos

Cuenta los dígitos de la parte entera. Si son 11 o menos, son segundos; si son 12 o más, milisegundos. En la práctica se distinguen con claridad, porque en este momento el valor en segundos tiene 10 dígitos y el valor en milisegundos tiene 13.

Para convertir un valor en segundos a fecha hay que llevarlo a milisegundos. El Date de JavaScript siempre trabaja en milisegundos, así que a un valor en segundos hay que multiplicarlo por 1000.

Paso 3: Hacer el cálculo

La forma más fiable es la consola de desarrollo del navegador. Si el valor está en segundos, multiplícalo por 1000 antes de introducirlo.

new Date(1700000000 * 1000).toString()       // hora local
new Date(1700000000 * 1000).toUTCString()    // UTC
new Date(1700000000 * 1000).toISOString()    // ISO 8601

Si prefieres la línea de comandos, en Mac puedes usar date -r 1700000000 -u y en Linux date -d @1700000000 -u para ver la hora en UTC.

En una hoja de cálculo, la fórmula =A1/86400 + DATE(1970,1,1) convierte el valor en segundos a una fecha UTC. Si quieres verlo en hora de Corea, solo tienes que sumar 9/24(UTC+9).

Paso 4: Pasar de UTC a la hora local

Cuando ya tienes el valor en UTC, añade el desplazamiento de tu zona. La hora estándar de Corea (KST) es UTC+9, así que sumando 9 horas a UTC obtienes la hora local.

Compruébalo con nuestra herramienta.

Timestamp Unix de ahora mismo · segundos y milisegundos

Si introduces un número, distingue automáticamente si son segundos o milisegundos y lo convierte a hora local, UTC e ISO; si eliges una fecha, la transforma en segundos y milisegundos. Todo se procesa en el navegador, sin instalar nada.

Por qué el mismo valor se ve distinto en local, UTC e ISO

Si introduces 1700000000 en la herramienta, aparecen tres líneas. Es un solo número, pero las horas se ven diferentes y eso puede confundir.

FormatoVisualizaciónSignificado
Local2023-11-15 07:13:20Según la zona horaria del navegador (KST = UTC+9)
UTC2023-11-14 22:13:20 UTCCon desplazamiento horario 0
ISO 86012023-11-14T22:13:20.000ZUTC expresado como cadena del estándar internacional

Los tres valores señalan el mismo instante. El timestamp es un valor absoluto sin zona horaria, así que solo cambia la forma de mostrarlo según cómo lo leas.

La hora local va 9 horas por delante de UTC porque KST es UTC+9. En este ejemplo, al sumar esas 9 horas la fecha también avanzó un día, del 14 al 15 de noviembre.

La Z al final de la cadena ISO 8601 indica que esa hora es UTC. Por eso la línea ISO y la línea UTC solo difieren en el formato, pero apuntan al mismo momento.

El error más común: confundir la unidad desvía el resultado 1000 veces

El fallo más habitual es elegir mal la unidad. Si tomas un valor en segundos como milisegundos, o un valor en milisegundos como segundos, el resultado se desvía unas 1000 veces.

Número introducidoUnidad aplicadaHora calculada (UTC)
1700000000 (10 dígitos)Segundos (correcto)2023-11-14 22:13:20
1700000000000 (13 dígitos)Milisegundos (correcto)2023-11-14 22:13:20
1700000000Tomado como milisegundos1970-01-20 16:13:20

1700000000 es originalmente un valor en segundos, así que hay que multiplicarlo por 1000 para llegar a 2023. Si lo introduces tal cual como milisegundos, son unos 1700 millones de milisegundos, es decir poco más de 20 días, y el resultado salta a enero de 1970.

Al contrario, si a un valor de 13 dígitos en milisegundos le multiplicas por 1000 una vez más por error, obtienes una fecha imposible, de decenas de miles de años. La herramienta detecta primero la unidad por la cantidad de dígitos y así reduce este tipo de error de multiplicación.

Conviene saber, además, que la detección por dígitos es una convención. Como todo lo de 12 dígitos o más se toma como milisegundos, la regla puede fallar con un valor en segundos que apunte a un futuro muy lejano.

En resumen

  • Un timestamp Unix son los segundos o milisegundos transcurridos desde 1970-01-01 00:00:00 UTC (la época).
  • Si tiene 11 dígitos o menos son segundos; si tiene 12 o más, milisegundos. Hoy el valor en segundos tiene 10 dígitos y el de milisegundos, 13.
  • Si confundes la unidad, el resultado se desvía unas 1000 veces y salta a cerca de 1970 o a un futuro absurdo.
  • Un mismo timestamp se muestra distinto en local, UTC e ISO según el desplazamiento horario, pero siempre es el mismo instante.
  • La Z al final de ISO 8601 indica que esa hora es UTC.
Timestamp Unix de ahora mismo · segundos y milisegundos

Si introduces un número, distingue automáticamente si son segundos o milisegundos y lo convierte a hora local, UTC e ISO; si eliges una fecha, la transforma en segundos y milisegundos. Todo se procesa en el navegador, sin instalar nada.

Preguntas frecuentes

¿Cómo distingo un número de 10 dígitos de uno de 13?

Por la cantidad de dígitos. La herramienta considera segundos hasta 11 dígitos y milisegundos a partir de 12. A día de hoy, el valor en segundos tiene 10 dígitos y el de milisegundos, 13, así que normalmente se distinguen sin problemas. Los valores en segundos se multiplican por 1000 internamente para calcular la fecha.

¿Por qué la hora local y la UTC salen distintas?

Porque el timestamp es un valor absoluto sin zona horaria, y la hora local es el resultado de sumarle el desplazamiento de la zona horaria de tu navegador. La hora estándar de Corea es UTC+9, así que la hora local aparece 9 horas por delante de UTC y, según el caso, la fecha también avanza un día. Las dos líneas solo cambian en la forma de mostrarlo, pero señalan el mismo instante.

¿También puedo convertir una fecha a timestamp?

Sí. En la segunda casilla de la herramienta eliges la fecha y la hora, y te muestra el valor en segundos y en milisegundos de ese instante, cada uno con su botón de copiar. El valor en segundos es el resultado de dividir los milisegundos entre 1000 y descartar los decimales.

¿El número que introduzco se envía a un servidor?

No. La detección de la unidad y el cálculo de la fecha se hacen al instante dentro del navegador. No hay envíos ni instalaciones de por medio: el resultado cambia en cuanto escribes.

Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano

Artículos relacionados

  1. Mayúsculas alternas e invertidas: cómo funcionan los 4 modosInvertir, alternar en aBaB o AbAb y mezclar al azar: qué hace cada modo, con ejemplos, y por qué los espacios, números y el coreano quedan intactos.
  2. Convertir TOML a JSON y JSON a TOML: cómo cambia la sintaxisQué pasa con [table], [[table]], las claves con punto y las tablas inline al convertir TOML y JSON, más las reglas del sentido inverso, con resultados reales.
  3. Generador TOTP: cómo se calcula el código de 6 dígitosAsí se combinan la clave Base32 y el contador de 30 segundos con HMAC-SHA1 para obtener los 6 dígitos, y por qué el código no coincide.
  4. Conversión de escape Unicode: \uXXXX, U+ y entidades HTMLAprende a convertir texto a \uXXXX, U+ y entidades HTML y a deshacerlo, con ejemplos de hangul y emojis y el motivo por el que un emoji se parte en dos.
  5. Normalizar URL: quitar utm y obtener el enlace canónicoAprende qué reglas sigue la normalización de URL: cómo se eliminan los parámetros utm_, fbclid, gclid y ref, y cómo leer la lista de cambios aplicados.
  6. Codificación URL: por qué el espacio se convierte en %20Por qué el espacio se convierte en %20 y cada letra coreana en %EA%B0%80, cuándo usar encodeURI o encodeURIComponent y cómo evitar la doble codificación.

Herramientas relacionadas