Las configuraciones de tiempo fallan en silencio cuando la unidad es incorrecta

Valores de configuración como 30000, 60 o 3600 son ambiguos a menos que conozcas la unidad esperada. Un timeout puede estar en milisegundos, un TTL de caché en segundos y un intervalo de monitorización en minutos.

Cómo convertir milisegundos, segundos, minutos y horas para timeouts y TTL

Cómo convertir milisegundos, segundos, minutos y horas para timeouts y TTL

El Conversor de unidades de tiempo convierte milisegundos, segundos, minutos, horas y días para que revises la configuración antes de que se convierta en un error.

Ejemplo: dejar los valores de configuración revisables

Supón que la configuración de un cliente de API contiene estos valores:

const apiClient = {
  timeout: 30000,
  retryDelay: 1500,
  cacheTtl: 86400,
};

Los números en bruto son difíciles de juzgar, pero alinear las unidades los hace revisables.

Configuración Valor bruto Se lee como
timeout 30000ms 30 segundos
retryDelay 1500ms 1,5 segundos
cacheTtl 86400s 24 horas

Convertidos así, el equipo puede discutir si el timeout de la API es razonable, si el retraso de reintento es demasiado corto y si la caché debe vivir hasta el día siguiente.

Conversiones habituales

30000ms son 30 segundos. 5 minutos son 300 segundos o 300000 milisegundos. 3600 segundos es una hora. Escribir estos valores en forma legible durante la revisión facilita detectar errores de configuración.

Combina duración y hora del reloj

Cuando necesites saber cuándo expira una marca de tiempo, combina la conversión de duración con el Conversor de marca de tiempo Unix o el Conversor de zonas horarias UTC y JST. Esto ayuda a traducir TTL y valores de expiración de tokens a fechas reales del calendario.

Confusiones habituales

Las unidades no son coherentes. Algunas API de Node.js y el setTimeout del navegador usan milisegundos, el EX de Redis usa segundos y la pantalla de ajustes de un servicio de monitorización puede usar minutos. Un simple 60 puede ser 60 milisegundos, 60 segundos o 60 minutos, así que poner la unidad en un comentario o en el nombre del ajuste facilita mucho la lectura posterior.

API_TIMEOUT_MS=30000
CACHE_TTL_SECONDS=3600
JOB_INTERVAL_MINUTES=5

Pon la unidad en el nombre de la variable de entorno y revisa el valor después de convertirlo a tiempo real con la herramienta. Incluso quien solo vea el archivo de configuración entenderá la intención.

Tabla rápida de conversiones

Estas son las conversiones que más aparecen al revisar ajustes. Úsala para comprobar cuando el cálculo mental te deje dudas.

Tiempo Segundos Milisegundos
1 segundo 1 1.000
1 minuto 60 60.000
5 minutos 300 300.000
1 hora 3.600 3.600.000
1 día 86.400 86.400.000

Si ves 86400 y reconoces de inmediato “un día”, puedes juzgar en el acto si el TTL de una caché es más largo de lo previsto. 300 (5 minutos) y 3600 (1 hora) también aparecen a menudo en intervalos de monitorización y en la vigencia de tokens.

El rango de conversión de la herramienta y cómo se muestran los resultados

Las unidades son milisegundos, segundos, minutos, horas, días y semanas. Los meses y los años no se incluyen porque su duración no es fija. Introduzca un valor y una unidad, y aparecen a la vez los valores en todas las unidades.

Entrada Resultado mostrado (extracto)
90 minutos 5400000 ms / 5400 s / 1,5 h / 0,0625 días / 0,008929 semanas
1,5 horas 90 min / 5400 s / 0,0625 días
0,1 segundos 100 ms / 0,001667 min / 2,777778e-5 h

Los decimales se redondean a seis cifras, así que los valores que no dividen exactamente se muestran cortos. Un valor muy pequeño (menor que 0,0001) o de mil millones o más se muestra en notación exponencial, como 2.777778e-5. Cuando vea un exponente, esa unidad está «varios órdenes de magnitud fuera». Leer el valor en una unidad de magnitud parecida ayuda a evitar interpretar mal una configuración.

También puede introducir una duración como texto. Lee formas con unidad como 1h30m, 1d 2h y 250ms, una forma de reloj como 01:30:00 (horas:minutos:segundos) y el formato ISO 8601 como PT1H30M, la convierte a milisegundos y luego a todas las unidades. Debajo de los resultados aparece una notación legible y la notación ISO 8601, como 1h 30m / PT1H30M. Un número sin unidad (90) no se lee porque podrían ser minutos o segundos, y los años y los meses (P1Y, P1M) no se leen porque su duración no es fija.

Resumen

Los milisegundos y los segundos son fáciles de confundir. Convierte los valores antes de pegarlos en la configuración y comprueba siempre la unidad que espera la biblioteca, la API o el servicio en la nube.

Preguntas frecuentes

¿Un valor como 30000 está en milisegundos o segundos?

Depende del contexto. Algunas APIs de Node.js y el setTimeout del navegador usan milisegundos, así que 30000 son 30 segundos, mientras que el EX de Redis está en segundos. El mismo “timeout” difiere según la biblioteca o el servicio, así que comprueba la unidad en la documentación y conviértela a una unidad legible con el Conversor de unidades de tiempo.

¿Cómo puedo evitar confundir las unidades?

Incluye la unidad en el nombre de la configuración o de la variable de entorno. API_TIMEOUT_MS, CACHE_TTL_SECONDS y JOB_INTERVAL_MINUTES transmiten la intención incluso a quien solo ve el valor. Un valor como 60 es especialmente arriesgado, ya que podría ser 60 ms, 60 s o 60 min.

Quiero saber cuándo expira realmente un TTL.

Para convertir un TTL en segundos en una fecha/hora real, combínalo con el Conversor de marca de tiempo Unix o el Conversor UTC y JST para ver la hora de expiración concreta.

¿Hay algún truco para recordar los números de segundos más comunes?

Memorizar los valores frecuentes acelera el juicio. 300 son 5 minutos, 3600 es 1 hora, 86400 es 1 día y 604800 es 1 semana. Aparecen a menudo en intervalos de monitorización, vigencia de tokens y TTL de cachés, así que usarlos como referencia y pensar en múltiplos facilita hacerse una idea aproximada.