Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Intl.RelativeTimeFormat — formattare il tempo relativo

Intl.RelativeTimeFormat crea descrizioni localizzate del tempo relativo. Il metodo format(value, unit) accetta un numero e un’unità, non una data; calcolare la differenza di tempo resta responsabilità dell’applicazione.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

const rtf = new Intl.RelativeTimeFormat(locales, { numeric: "auto", style: "long" });
rtf.format(value, unit);

Intl.RelativeTimeFormat fa parte dello standard di internazionalizzazione ECMA-402, non delle API DOM. Crea un’istanza con new. Qui, RelativeTimeFormat.format indica il metodo d’istanza Intl.RelativeTimeFormat.prototype.format(value, unit), che restituisce testo. I numeri negativi descrivono il passato e quelli positivi il futuro; il metodo non calcola le differenze tra date.

unit accetta second, minute, hour, day, week, month, quarter, year e le rispettive forme plurali inglesi. Un’unità non supportata, NaN o l’infinito causano un RangeError.

Il valore predefinito numeric: "always" esclude espressioni particolari come yesterday, ma lo schema di formattazione della lingua può esprimere la quantità senza indicare esplicitamente un numero. In arabo, per esempio, la forma duale di un sostantivo può indicare due giorni senza un elemento numerico separato. numeric: "auto" consente espressioni come yesterday quando disponibili. style accetta long (il valore predefinito), short o narrow.

L’esempio seleziona esplicitamente en e valori fissi. Il testo esatto dipende dai dati locali. Verifica la disponibilità del costruttore e della lingua richiesta nel browser di destinazione; la presenza di Node 24 in un repository non dimostra il supporto del browser.

Esempi

const rtf = new Intl.RelativeTimeFormat("en", { numeric: "auto" });
console.log(rtf.format(-1, "day"));
console.log(rtf.format(1, "day"));

Risultato

yesterday
tomorrow

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti