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.