Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Intl.RelativeTimeFormat — formátovanie relatívneho času

Intl.RelativeTimeFormat vytvára lokalizované opisy relatívneho času. Metóda format(value, unit) prijíma číslo a jednotku, nie dátum; výpočet časového rozdielu zostáva úlohou aplikácie.

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

Syntax

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

Intl.RelativeTimeFormat patrí do štandardu internacionalizácie ECMA-402, nie medzi rozhrania DOM. Inštanciu vytvorte pomocou new. RelativeTimeFormat.format tu označuje inštančnú metódu Intl.RelativeTimeFormat.prototype.format(value, unit), ktorá vracia text. Záporné čísla opisujú minulosť a kladné budúcnosť; metóda rozdiely medzi dátumami nepočíta.

unit prijíma second, minute, hour, day, week, month, quarter, year a ich anglické množné tvary. Nepodporovaná jednotka, NaN alebo nekonečno spôsobia chybu RangeError.

Pri predvolenej hodnote numeric: "always" sa nepoužívajú osobitné výrazy ako yesterday, ale vzor pre dané jazykové nastavenie môže vyjadriť množstvo bez výslovného uvedenia čísla. Napríklad v arabčine môže dvojné číslo podstatného mena označovať dva dni bez samostatnej číselnej zložky. numeric: "auto" umožňuje výrazy ako yesterday, ak sú dostupné. style prijíma long (predvolené), short alebo narrow.

Príklad výslovne vyberá en a pevné hodnoty. Presné znenie závisí od lokalizačných údajov. Overte, či sú konštruktor a požadované jazykové nastavenie dostupné v cieľovom prehliadači; prítomnosť Node 24 v repozitári nedokazuje podporu v prehliadači.

Príklady

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

Výsledok

yesterday
tomorrow

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje