Convertir timestamp Unix

Un timestamp Unix cuenta desde el 1 de enero de 1970. En segundos, las fechas actuales tienen diez cifras; en milisegundos, trece. Esa diferencia de tamaño es lo que permite deducir la unidad sin preguntar, y el umbral está muy lejos de cualquier fecha que alguien vaya a mirar.

La deducción se dice siempre, porque el fallo clásico de esta conversión es acertar en silencio. Un número en milisegundos leído como segundos da una fecha en el año 55.000 y se nota; al revés da 1970 y también. Lo que no se nota es una herramienta que decida sola y no lo cuente.

El número no lleva zona horaria: es un instante absoluto. La zona aparece al escribirlo como fecha, y de ahí sale el malentendido más caro de esta conversión — dos personas mirando el mismo timestamp y leyendo días distintos porque están en husos distintos.

Por eso salen las dos. En España la diferencia con UTC es de una hora en invierno y de dos en verano, así que un evento de las 23:30 UTC ya es del día siguiente en Madrid. Cuando se compara un registro con lo que dice un panel de control, la mitad de las discrepancias son exactamente esto.

La hora local se calcula con las reglas de tu zona en esa fecha concreta, no con las de hoy. Importa porque el cambio de hora hace que en la madrugada del último domingo de octubre haya una hora que ocurre dos veces, y en la de marzo una que no existe.

Un informe agrupado por hora local tiene por tanto un cubo doble en octubre y uno vacío en marzo. No es un fallo del informe: es que la hora local no es una recta. Los sistemas que guardan en UTC y convierten al mostrar se libran de esto; los que guardan en local, no.

Un timestamp guardado en un entero de 32 bits con signo se desborda el 19 de enero de 2038 y salta a 1901. Suena lejano y ya no lo es: cualquier cálculo que mire veinte años hacia delante — una hipoteca, un certificado, un plan de amortización — cruza esa frontera hoy.

Los sistemas modernos usan 64 bits y no tienen el problema. Lo que queda son formatos binarios antiguos, sistemas empotrados y columnas de bases de datos declaradas hace mucho. Es la clase de fallo que no aparece hasta que alguien introduce una fecha lejana, y entonces aparece de golpe.

La forma `2023-11-14T22:13:20Z` está pensada para que ordenarla como texto la ordene también como fecha. Por eso es la que conviene en nombres de fichero, en claves y en cualquier sitio donde algo vaya a ordenar alfabéticamente sin saber que está mirando fechas.

La `Z` del final significa UTC. Su ausencia es una fuente inagotable de errores: una cadena sin zona la interpreta cada sistema con su propia suposición, y dos servicios pueden leer el mismo texto como dos instantes separados por horas. Si vas a escribir una fecha, escribe la zona.

El tiempo Unix finge que todos los días tienen exactamente 86.400 segundos, lo cual es falso: se han añadido veintisiete segundos intercalares desde 1972 para compensar el giro irregular de la Tierra. El formato sencillamente los ignora.

Para casi todo el mundo es la decisión correcta, porque hace que la aritmética de fechas funcione. Deja de serlo en astronomía, en sistemas de navegación y en algunas mediciones científicas, donde importan de verdad — y ahí no se usa tiempo Unix sino escalas que sí los cuentan.

La numeración de semanas ISO define la semana 1 como la que contiene el primer jueves del año, y las semanas empiezan en lunes. De ahí sale que el 1 de enero pueda caer en la semana 52 del año anterior, y que el 31 de diciembre pueda ser ya semana 1 del siguiente.

Ese detalle rompe informes semanales todos los eneros. La regla práctica es que el año de la semana no es siempre el año de la fecha, y quien agrupa por semana necesita guardar los dos juntos — un «semana 1» sin año es ambiguo justo en las fechas en que más se consulta.

La línea de tiempo relativo — «hace tres años», «hace once minutos» — no aporta precisión, aporta escala. Es lo que responde de un vistazo si un registro es de esta mañana o del despliegue del mes pasado, que suele ser la pregunta real detrás de mirar un timestamp.

Está escrita en tu idioma con el formateador que el navegador trae incorporado, así que las formas son las españolas de verdad y no una traducción de plantillas inglesas. Para la respuesta exacta están las otras líneas; esta es para orientarse.

Un timestamp casi nunca viaja solo: se copia de una línea de registro, de una fila de base de datos o de un payload que lleva al lado un identificador de usuario. Como la conversión ocurre en la página, ni el número ni lo que le acompañe salen de tu equipo.

Además, tu zona horaria es un dato que identifica bastante más de lo que parece, y aquí se usa la del navegador sin que salga a ninguna parte. La conversión a hora local la hace tu propio equipo, que es el único que necesita saberlo.