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

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