CKTIS / JavaScript
Intl.RelativeTimeFormat.prototype.format() — formátování relativního času
Převede časový posun se znaménkem a zadanou jednotku na lokalizovaný text. Metoda sama nepočítá rozdíl mezi daty.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
const formatter = new Intl.RelativeTimeFormat(locales, options);
formatter.format(value, unit);Intl.RelativeTimeFormat.prototype.format je metoda instance. Volání formatter.format(value, unit) vrací řetězec podle skutečně zvoleného jazykového a regionálního nastavení a voleb z konstruktoru. Posun od referenčního bodu počítá aplikace, která také volí jednotku; metoda nezjišťuje aktuální čas ani neodečítá data.
Záporné hodnoty označují minulost, kladné budoucnost. Při použití číselného vzoru vybírá -0 vzor pro minulost a +0 pro budoucnost. unit přijímá přesné identifikátory "second", "minute", "hour", "day", "week", "month", "quarter" a "year" i jejich tvary s koncovým s. Tvar identifikátoru neurčuje gramatiku výsledku.
numeric: "always" (výchozí) používá číselný vzor. numeric: "auto" použije samostatný výraz, například yesterday, pokud je dostupný; jinak použije číselný vzor. style vybírá "long" (výchozí), "short" nebo "narrow". Podpora závisí na běhovém prostředí a text se může lišit i při stejném jazykovém a regionálním nastavení, například použitím nezlomitelných mezer. V přenositelných testech neporovnávej výsledek s pevně zadaným textem.
Metoda vyžaduje instanci jako this; samostatné volání bez platného this vyvolá TypeError. Pro zpětné volání použij formatter.format.bind(formatter). Po kontrole this metoda použije ToNumber na value a pak ToString na unit. Například BigInt jako value vyvolá TypeError. Po převodu způsobí NaN, Infinity, -Infinity nebo nepodporovaný identifikátor jednotky chybu RangeError.
Příklady
{
const numeric = new Intl.RelativeTimeFormat("en", { numeric: "always" });
const auto = new Intl.RelativeTimeFormat("en", { numeric: "auto" });
const past = numeric.format(-1, "day");
console.log(past);
console.log(auto.format(-1, "day"));
console.log(past === numeric.format(-1, "days"));
}Výsledek
1 day ago yesterday true
Pro stejný posun o `-1` den ukazují první dva řádky běžný anglický text pro `"always"` a `"auto"`. Třetí řádek ukazuje, že `"day"` a `"days"` jsou rovnocenné.
Související lekce
- JavaScript · Lekce 24 · Pokročilá · Verze: 4
Zdroje
- ECMAScript® 2024 Internationalization API Specification — Intl.RelativeTimeFormat.prototype.format
- ECMAScript® 2024 Internationalization API Specification — PartitionRelativeTimePattern
- ECMAScript Internationalization API Specification (living draft) — Intl.RelativeTimeFormat.prototype.format
- Intl.RelativeTimeFormat.prototype.format() - JavaScript | MDN