GameParticles
Fecha y hora

Timestamps Unix explicados: segundos, milisegundos y zonas horarias

Qué es un timestamp Unix, cómo distinguir segundos de milisegundos, por qué la zona horaria no lo cambia, el problema de 2038 y cómo convertirlo en código.

Actualizado

Un timestamp Unix es un conteo de segundos desde la época Unix, las 00:00:00 UTC del 1 de enero de 1970. 1696118400 significa 1 696 118 400 segundos después de ese momento, que es la medianoche UTC del 1 de octubre de 2023. Es el mismo número en todos los países, porque la zona horaria solo interviene cuando conviertes el conteo en una fecha de calendario para que la lea una persona.

Por qué las computadoras cuentan segundos

Las fechas son incómodas de almacenar y comparar. Los meses tienen duraciones distintas, los años a veces tienen 366 días y cada región escribe las partes en un orden diferente. Un único entero evita todo eso. Dos timestamps se pueden comparar con un signo de menor que, restar para obtener una duración, ordenar como números simples y almacenar en un número fijo de bytes.

Por eso las bases de datos, los archivos de log, los tokens JWT, las cabeceras de caché y la mayoría de las API intercambian el tiempo como un valor epoch. Algunas referencias te ayudan a reconocer uno cuando lo ves:

  • 0 es 1970-01-01T00:00:00Z, la época en sí.
  • 1000000000 es 2001-09-09T01:46:40Z, el segundo mil millones.
  • 1696118400 es 2023-10-01T00:00:00Z.
  • 1791676800 es 2026-10-11T00:00:00Z.
  • 2147483647 es 2038-01-19T03:14:07Z, el límite de 32 bits.

Los valores negativos están permitidos y significan fechas anteriores a 1970, aunque no todos los sistemas los manejan.

Segundos frente a milisegundos

La definición original cuenta segundos, y eso es lo que devuelven las herramientas de Unix, time.time() de Python y la mayoría de las bases de datos. JavaScript rompió la convención. Date.now() devuelve milisegundos, así que el mismo instante aparece como 1696118400000. System.currentTimeMillis() de Java y muchos frameworks de logging siguen a JavaScript.

Mezclar los dos es el error de timestamps más común. Pasa un valor en milisegundos donde se esperan segundos y la fecha cae alrededor del año 55 000. Pasa segundos donde se esperan milisegundos y todas las fechas se convierten en el 20 de enero de 1970. La comprobación rápida es contar los dígitos: los valores actuales tienen 10 dígitos en segundos y 13 en milisegundos. Algunos sistemas van más allá, con 16 dígitos para microsegundos y 19 para nanosegundos.

Convertir es multiplicar o dividir por 1000. En JavaScript, los segundos salen de Math.floor(Date.now() / 1000), y un valor en segundos se convierte en fecha con new Date(ts * 1000). El conversor de timestamps Unix detecta la unidad automáticamente por la longitud y muestra la fecha decodificada junto a su forma ISO 8601, lo que te ahorra adivinar.

Las zonas horarias no cambian el número

Un timestamp nombra un instante, no una hora de reloj. 1696118400 es la medianoche del 1 de octubre en Londres, pero son las 20:00 del 30 de septiembre en Nueva York, las 05:30 del 1 de octubre en Bombay y las 09:00 del 1 de octubre en Tokio. Los cuatro son el mismo instante y el mismo número. Solo cambia cómo se muestra.

Por eso la regla sensata para cualquier sistema es: almacena y transmite los timestamps en UTC, y convierte a la hora local en el último momento posible, en la interfaz de usuario. Si en cambio guardas una hora local, pierdes el instante. "Las 2:30 del 5 de noviembre" ocurre dos veces en Nueva York cuando los relojes se atrasan, y nunca en la fecha de primavera en que se adelantan.

El horario de verano es la razón principal para evitar la aritmética con horas locales. Sumar 86400 segundos a un timestamp siempre avanza exactamente un día de tiempo real, pero ese día puede tener 23 o 25 horas en el reloj local. Si necesitas "mañana a la misma hora" en la zona de un usuario, haz el cálculo en términos de calendario con una biblioteca que entienda de zonas horarias, no sumando segundos.

Cuando necesites ver cómo se ve un instante concreto en distintas oficinas, el conversor de zonas horarias toma una fecha y una hora y lista el equivalente en más de 30 zonas, lo cual es más rápido que razonar a mano con los desfases.

Los segundos intercalares y el límite de 2038

La hora Unix finge que todos los días tienen exactamente 86400 segundos. Los días reales incluyen de vez en cuando un segundo intercalar, y cuando ocurre, el reloj del sistema repite o estira un segundo en lugar de contar hasta 60. Para casi todas las aplicaciones esto es invisible, pero es la razón por la que la hora Unix no es exactamente igual al número de segundos reales transcurridos desde 1970.

El problema de 2038 es más práctico. Un entero de 32 bits con signo llega como máximo a 2147483647. Un segundo después, el 19 de enero de 2038 a las 03:14:08 UTC, da la vuelta a un número negativo grande, que se decodifica como diciembre de 1901. Los sistemas operativos, lenguajes y bases de datos modernos usan valores de 64 bits y están a salvo durante los próximos 292 000 millones de años. El riesgo está en dispositivos embebidos antiguos, formatos de archivo heredados y cualquier esquema que haya elegido INT en lugar de BIGINT para una columna epoch.

Trabajar con timestamps en código

Las conversiones vienen integradas en todos los lenguajes, pero la forma varía:

  • Shell: date +%s imprime el timestamp actual, y date -u -d @1696118400 decodifica uno en Linux.
  • Python: datetime.fromtimestamp(1696118400, tz=timezone.utc) e int(dt.timestamp()).
  • JavaScript: new Date(1696118400 * 1000).toISOString() y Math.floor(date.getTime() / 1000).
  • SQL: to_timestamp(1696118400) en PostgreSQL, FROM_UNIXTIME(1696118400) en MySQL.
  • Excel: =A1/86400 + DATE(1970,1,1) convierte un valor en segundos en un número de serie de fecha.

Las duraciones son una simple resta. Los dos timestamps 1696118400 y 1696204800 difieren en 86400, que es un día. Divide entre 3600 para obtener horas o entre 604800 para obtener semanas. Cuando el resultado hay que expresarlo en unidades de calendario, como "2 años, 3 meses y 14 días", la resta simple ya no alcanza porque la duración de los meses varía. La calculadora de duración hace ese desglose a partir de dos fechas y también muestra los totales en días, horas y segundos.

Hay más conversores de fechas, expresiones cron y programaciones en la categoría de fecha y hora.

Pruébalo

Pega 1696118400 en el conversor de timestamps Unix para ver el 1 de octubre de 2023 en UTC, y después pega 1696118400000 y confirma que detecta los milisegundos y llega al mismo instante.

Herramientas de esta guía

Preguntas frecuentes

¿Qué es un timestamp Unix?

Es el número de segundos transcurridos desde las 00:00:00 UTC del 1 de enero de 1970, sin contar los segundos intercalares. El valor 0 es ese momento, y 1696118400 es el 1 de octubre de 2023 a medianoche UTC.

¿Cómo sé si un timestamp está en segundos o en milisegundos?

Cuenta los dígitos. Los timestamps actuales en segundos tienen 10 dígitos y los que están en milisegundos tienen 13. Si una fecha se decodifica como 1970 o como el año 50 000, tienes la unidad equivocada.

¿Un timestamp Unix cambia con la zona horaria?

No. Identifica un único instante en todo el mundo. Las zonas horarias solo importan cuando lo conviertes en una fecha de calendario y una hora de reloj para mostrarlo.

¿Qué es el problema del año 2038?

Los sistemas que guardan la hora Unix en un entero de 32 bits con signo se desbordan en 2147483647, que es el 19 de enero de 2038 a las 03:14:07 UTC. Los sistemas modernos usan valores de 64 bits y no se ven afectados.

Más guías de fecha y hora

Formateador de JSON
Desarrollo · Formatea, valida y minifica JSON con resaltado de sintaxis.
↵
Codificar / decodificar Base64
Desarrollo · Codifica texto en Base64 o decodifica Base64 a texto plano.
↵
Codificador / Decodificador de URL
Desarrollo · Codifica o decodifica componentes de URL y cadenas de consulta.
↵
Generador de hash
Desarrollo · Genera hashes MD5, SHA-1, SHA-256 y SHA-512.
↵
Generador de UUID
Desarrollo · Genera UUID v4 (aleatorios) en lote con un clic.
↵
Probador de regex
Desarrollo · Prueba expresiones regulares sobre un texto con resaltado de coincidencias en vivo.
↵
Contador de palabras
Texto · Cuenta palabras, caracteres, frases, párrafos y tiempo de lectura.
↵
Conversor de mayúsculas y minúsculas
Texto · Convierte texto a MAYÚSCULAS, minúsculas, Título, camelCase, snake_case y más.
↵
Ordenador de listas
Texto · Ordena, invierte, baraja y quita duplicados de listas de texto.
↵
Vista previa de Markdown
Texto · Escribe Markdown y mira la vista previa renderizada en vivo, lado a lado.
↵
Calculadora de porcentajes
Números · Calcula porcentajes, aumentos, descuentos y qué % es un número de otro.
↵
Conversor de colores
Colores · Convierte colores entre HEX, RGB, HSL y HSV al instante.
↵
Snake
Arcade · Come, crece y no choques con las paredes. Un clásico eterno.
↵
2048
Puzles · Desliza y combina fichas hasta conseguir la legendaria ficha 2048.
↵
Word Grid
Puzles · Adivina la palabra oculta de cinco letras en seis intentos con pistas de colores.
↵
Sudoku
Puzles · Completa la cuadrícula 9x9 con lógica. Cuatro niveles, de fácil a experto.
↵
Buscaminas
Estrategia · Usa las pistas numéricas para despejar el campo de minas. Lógica clásica, tres niveles.
↵
Breakout
Arcade · Rompe todos los ladrillos con barra y bola. Power-ups, combos y niveles sin fin.
↵
Práctica de mecanografía
Casual · Mejora tus PPM y tu precisión con prácticas de 30 segundos a 5 minutos. Descubre tus teclas débiles.
↵
TypeRunner
Arcade · Carrera de mecanografía multijugador. Reta a tus amigos con un enlace, vence a la máquina o persigue a tu fantasma.
↵
Typing Blocks
Arcade · Escribe cada palabra antes de que su bloque de madera aterrice. Si fallas, la pila sube hacia la línea.
↵
Bubble Shooter
Arcade · Apunta, rebota en las paredes y explota grupos de tres o más burbujas.
↵
Road Rush
Arcade · Corre contra siete rivales entre el tráfico y ábrete paso a golpes.
↵