CKTIS / JavaScript
Intl.RelativeTimeFormat.prototype.format() — formátovanie relatívneho času
Prevedie časový posun so znamienkom a zadanú jednotku na lokalizovaný text. Metóda sama nepočíta rozdiel medzi dátumami.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const formatter = new Intl.RelativeTimeFormat(locales, options);
formatter.format(value, unit);Intl.RelativeTimeFormat.prototype.format je metóda inštancie. Volanie formatter.format(value, unit) vráti reťazec podľa skutočne zvolených jazykových a regionálnych nastavení a volieb z konštruktora. Posun od referenčného bodu vypočíta aplikácia a sama zvolí jednotku; metóda nezisťuje aktuálny čas ani neodčítava dátumy.
Záporné hodnoty označujú minulosť, kladné budúcnosť. Pri použití číselného vzoru vyberie -0 vzor pre minulosť a +0 vzor pre budúcnosť. unit prijíma presné identifikátory "second", "minute", "hour", "day", "week", "month", "quarter" a "year" aj ich tvary s koncovým s. Tvar identifikátora neurčuje gramatiku výsledku.
numeric: "always" (predvolená voľba) používa číselný vzor. numeric: "auto" použije osobitný výraz, napríklad yesterday, ak je dostupný; inak použije číselný vzor. style vyberá "long" (predvolená voľba), "short" alebo "narrow". Podpora závisí od prostredia vykonávania a text sa môže líšiť aj pri rovnakých jazykových a regionálnych nastaveniach, napríklad použitím nedeliteľných medzier. V prenosných testoch neporovnávaj výsledok s pevne zadaným textom.
Metóda vyžaduje inštanciu ako this; samostatné volanie bez platného this vyvolá TypeError. Ako funkciu spätného volania použi formatter.format.bind(formatter). Po kontrole this metóda použije ToNumber na value a potom ToString na unit. Napríklad BigInt ako value vyvolá TypeError. Po konverzii NaN, Infinity, -Infinity alebo nepodporovaný identifikátor jednotky spôsobí RangeError.
Prí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ýsledok
1 day ago yesterday true
Pri rovnakom posune o `-1` deň ukazujú prvé dva riadky bežný anglický text pre `"always"` a `"auto"`. Tretí riadok ukazuje, že `"day"` a `"days"` sú rovnocenné.
Súvisiace lekcie
- JavaScript · Lekcia 24 · Pokročilá · Verzia: 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