Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje