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

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