Convertir timestamp a fecha: segundos, milisegundos y UTC

Contenido
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.
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.
| Formato | Visualización | Significado |
|---|---|---|
| Local | 2023-11-15 07:13:20 | Según la zona horaria del navegador (KST = UTC+9) |
| UTC | 2023-11-14 22:13:20 UTC | Con desplazamiento horario 0 |
| ISO 8601 | 2023-11-14T22:13:20.000Z | UTC 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 introducido | Unidad aplicada | Hora 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 |
| 1700000000 | Tomado como milisegundos | 1970-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
Zal final de ISO 8601 indica que esa hora es UTC.
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