CKTIS / JavaScript
Intl.RelativeTimeFormat — formátování relativního času
Intl.RelativeTimeFormat vytváří lokalizované popisy relativního času. Metoda format(value, unit) přijímá číslo a jednotku, nikoli datum; výpočet časového rozdílu zůstává na aplikaci.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
const rtf = new Intl.RelativeTimeFormat(locales, { numeric: "auto", style: "long" });
rtf.format(value, unit);Intl.RelativeTimeFormat patří do standardu internacionalizace ECMA-402, nikoli mezi rozhraní DOM. Instanci vytvořte pomocí new. RelativeTimeFormat.format zde označuje instanční metodu Intl.RelativeTimeFormat.prototype.format(value, unit), která vrací text. Záporná čísla popisují minulost a kladná budoucnost; metoda rozdíly mezi daty nepočítá.
unit přijímá second, minute, hour, day, week, month, quarter, year a jejich anglické množné tvary. Nepodporovaná jednotka, NaN nebo nekonečno způsobí chybu RangeError.
Při výchozí hodnotě numeric: "always" se nepoužívají zvláštní výrazy jako yesterday, ale vzor pro dané jazykové nastavení může vyjádřit množství bez výslovného uvedení čísla. Například v arabštině může duál podstatného jména označit dva dny bez samostatné číselné části. numeric: "auto" umožňuje výrazy jako yesterday, pokud jsou k dispozici. style přijímá long (výchozí), short nebo narrow.
Příklad výslovně vybírá en a pevné hodnoty. Přesné znění závisí na lokalizačních datech. Ověřte, zda jsou konstruktor a požadované jazykové nastavení dostupné v cílovém prohlížeči; přítomnost Node 24 v repozitáři nedokládá podporu v prohlížeči.
Příklady
const rtf = new Intl.RelativeTimeFormat("en", { numeric: "auto" });
console.log(rtf.format(-1, "day"));
console.log(rtf.format(1, "day"));Výsledek
yesterday tomorrow
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.