CKTIS / JavaScript
Intl.RelativeTimeFormat — dar formato al tiempo relativo
Intl.RelativeTimeFormat crea descripciones localizadas de tiempo relativo. Su método format(value, unit) recibe un número y una unidad, no una fecha; calcular la diferencia de tiempo sigue siendo responsabilidad de la aplicación.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
const rtf = new Intl.RelativeTimeFormat(locales, { numeric: "auto", style: "long" });
rtf.format(value, unit);Intl.RelativeTimeFormat forma parte del estándar de internacionalización ECMA-402, no de las API del DOM. Crea una instancia con new. Aquí, RelativeTimeFormat.format se refiere al método de instancia Intl.RelativeTimeFormat.prototype.format(value, unit), que devuelve texto. Los números negativos describen el pasado y los positivos, el futuro; el método no calcula diferencias entre fechas.
unit acepta second, minute, hour, day, week, month, quarter, year y sus formas plurales en inglés. Una unidad no admitida, NaN o el infinito provocan un RangeError.
El valor predeterminado numeric: "always" evita expresiones especiales como yesterday, pero el patrón de la configuración regional puede expresar la cantidad sin indicar un número de forma explícita. Por ejemplo, en árabe, la forma dual de un sustantivo puede indicar dos días sin un elemento numérico separado. numeric: "auto" permite expresiones como yesterday cuando están disponibles. style acepta long (el valor predeterminado), short o narrow.
El ejemplo selecciona explícitamente en y valores fijos. El texto exacto depende de los datos de configuración regional. Comprueba que el constructor y la configuración regional necesaria estén disponibles en el navegador de destino; que Node 24 esté presente en un repositorio no demuestra que el navegador lo admita.
Ejemplos
const rtf = new Intl.RelativeTimeFormat("en", { numeric: "auto" });
console.log(rtf.format(-1, "day"));
console.log(rtf.format(1, "day"));Resultado
yesterday tomorrow
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.