Conversor de Marca de Tiempo Unix

Conversor de Marca de Tiempo Unix

Convierte al instante entre marcas de tiempo Unix (epoch) y fechas y horas legibles. Esta herramienta la usan a diario desarrolladores de software que depuran archivos de registro, administradores de bases de datos que leen marcas de tiempo almacenadas, analistas de datos que trabajan con respuestas de API, y cualquier persona que necesite saber exactamente qué momento representa un número de 10 dígitos como 1746057600.

Cómo Funciona la Conversión de Marca de Tiempo Unix

Una marca de tiempo Unix es un recuento de segundos transcurridos desde el epoch de Unix -- el 1 de enero de 1970, 00:00:00 UTC. Cada segundo que pasa incrementa la marca de tiempo en 1.

De marca de tiempo a fecha -- el total de segundos se convierte dividiendo primero los años (teniendo en cuenta los años bisiestos de 365 y 366 días), luego los meses (de longitud variable), después los días, horas, minutos y los segundos restantes. El resultado siempre está en UTC; mostrar la hora local requiere sumar o restar el desfase de zona horaria en segundos.

De fecha a marca de tiempo -- se suman todos los componentes desde el epoch: años x 31.536.000 (ajustado por años bisiestos) + días del mes x 86.400 + horas x 3.600 + minutos x 60 + segundos. Ejemplo: 1 de enero de 2025, 00:00:00 UTC = 1.735.689.600.

Segundos frente a milisegundos -- Date.now() de JavaScript y muchas API REST devuelven milisegundos desde el epoch (un número de 13 dígitos como 1.735.689.600.000). La hora Unix estándar usa segundos (10 dígitos). Divide los milisegundos entre 1.000 para obtener segundos; multiplica los segundos por 1.000 para obtener milisegundos.

Ejemplos Resueltos

Ejemplo 1 -- Leer un registro de servidor. Un registro de acceso de nginx muestra una solicitud en la marca de tiempo 1700000000. Convirtiendo: 1.700.000.000 segundos / 86.400 = 19.675,9 días después del 1 de enero de 1970 = 14 de noviembre de 2023, 22:13:20 UTC. En la hora del este de EE. UU. (UTC-5), eso es el 14 de noviembre de 2023 a las 5:13:20 PM.

Ejemplo 2 -- Encabezado de límite de tasa de una API. Una respuesta de la API de GitHub incluye X-RateLimit-Reset: 1746057600. Convirtiendo: esto es el 30 de abril de 2025, 16:00:00 UTC. Si la hora actual es las 15:45 UTC, el límite de tasa se restablece en 15 minutos.

Ejemplo 3 -- Aritmética de marcas de tiempo en una base de datos. Una sesión de usuario almacenada en PostgreSQL comenzó en created_at = 1735689600 y expiró en 1735693200. La diferencia es de 3.600 segundos = exactamente 1 hora. La aritmética con marcas de tiempo es una simple resta, sin necesidad de ninguna librería de fechas.

Tabla de Referencia

Cuándo Usarlo

• Descifrar marcas de tiempo en registros de servidor, informes de fallos o paneles de monitorización donde los eventos se almacenan como enteros.
• Convertir campos de respuesta de API (expiración de JWT, expiración de token OAuth, marcas de tiempo de webhooks) a fechas legibles para depurar.
• Generar una marca de tiempo Unix futura o pasada para usarla en una consulta de base de datos, una llamada a una API o una tarea programada.
• Calcular la diferencia de tiempo entre dos eventos almacenados como marcas de tiempo Unix restando una de la otra.
• Verificar que una marca de tiempo de un sistema externo representa la fecha que esperas antes de usarla en código de producción.

Errores Comunes

1. Confundir segundos con milisegundos. Una marca de tiempo de 10 dígitos como 1700000000 está en segundos; una de 13 dígitos como 1700000000000 está en milisegundos. Tratar una marca de tiempo en milisegundos como si fuera en segundos da una fecha 1.000 veces más lejana en el futuro -- el número 1700000000000 interpretado como segundos correspondería al año 55.000. Comprueba siempre el número de dígitos: 10 dígitos = segundos, 13 dígitos = milisegundos.
2. Mostrar marcas de tiempo UTC como hora local sin convertirlas. Una marca de tiempo de 1700000000 corresponde al 14 de noviembre de 2023, a las 22:13:20 UTC. En Nueva York (UTC-5 en noviembre), son las 5:13 PM. Mostrar la hora UTC a un usuario de Nueva York sin indicar que es UTC provoca discrepancias confusas de 5 horas.
3. Suponer que todos los sistemas usan la misma precisión de marca de tiempo. time.time() de Python devuelve segundos con decimales fraccionarios (por ejemplo, 1700000000.123456). Date.now() de JavaScript devuelve milisegundos enteros. UNIX_TIMESTAMP() de MySQL devuelve segundos enteros. Mezclar estos formatos sin normalizarlos causa errores de comparación de uno en uno o de mil en mil.
4. Ignorar las marcas de tiempo negativas. Las marcas de tiempo Unix anteriores al 1 de enero de 1970 son negativas. La marca de tiempo -86400 corresponde al 31 de diciembre de 1969, a las 00:00:00 UTC. Algunos sistemas y librerías de lenguajes más antiguos no manejan correctamente las marcas de tiempo negativas y pueden devolver errores o fechas incorrectas para cualquier fecha anterior a 1970.

Referencias Rápidas

Constantes útiles para cálculos aproximados con marcas de tiempo:

Consejos

1. Una marca de tiempo Unix de 10 dígitos que empieza por 17 corresponde a una fecha entre finales de 2023 y aproximadamente mediados de 2027. Una marca de tiempo que empieza por 16 corresponde a 2020-2023. Usa los primeros dígitos como una comprobación rápida de coherencia.
2. Para obtener la marca de tiempo Unix actual: JavaScript -- Math.floor(Date.now() / 1000), Python -- int(time.time()), Bash -- date +%s, SQL (MySQL) -- UNIX_TIMESTAMP(), SQL (PostgreSQL) -- EXTRACT(EPOCH FROM NOW()).
3. Para encontrar la marca de tiempo de la medianoche UTC en cualquier fecha, introduce la fecha a las 00:00:00 UTC. Las marcas de tiempo de medianoche siempre son divisibles entre 86.400.
4. Almacena todas las marcas de tiempo en tu base de datos como UTC. Convierte a la zona horaria local del usuario solo en la capa de presentación. Esto evita errores cuando los usuarios cambian de zona horaria o cuando ocurren transiciones de horario de verano.
5. El problema del año 2038 afecta a las marcas de tiempo almacenadas como enteros con signo de 32 bits, que alcanzan su máximo en 2.147.483.647 (19 de enero de 2038, 03:14:07 UTC). Si tu sistema todavía almacena marcas de tiempo como enteros de 32 bits, planifica la migración a enteros de 64 bits antes de 2038.
6. Al comparar dos marcas de tiempo de sistemas diferentes, verifica que usen el mismo epoch. La mayoría de los sistemas usan el 1 de enero de 1970, pero el FILETIME de Windows usa el 1 de enero de 1601, y NTP usa el 1 de enero de 1900. Convertir entre epochs requiere sumar o restar la diferencia en segundos entre las dos fechas de referencia.