Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

Intl.RelativeTimeFormat.prototype.format() — oblikovanje relativnog vremena

Pretvara vremenski pomak s predznakom i izričito zadanu jedinicu u lokalizirani tekst. Metoda ne računa razliku između datuma.

Verzija: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

const formatter = new Intl.RelativeTimeFormat(locales, options);
formatter.format(value, unit);

Intl.RelativeTimeFormat.prototype.format metoda je instance. Poziv formatter.format(value, unit) vraća znakovni niz prema stvarno odabranim jezičnim i regionalnim postavkama te opcijama zadanima u konstruktoru. Aplikacija računa pomak od referentne točke i bira jedinicu; metoda ne očitava sat niti oduzima datume.

Negativne vrijednosti označavaju prošlost, a pozitivne budućnost. Pri uporabi brojčanog obrasca -0 odabire obrazac za prošlost, a +0 obrazac za budućnost. unit prihvaća točne identifikatore "second", "minute", "hour", "day", "week", "month", "quarter" i "year" te njihove oblike sa završnim s. Oblik identifikatora ne određuje gramatiku rezultata.

numeric: "always" (zadano) rabi brojčani obrazac. numeric: "auto" rabi poseban izraz, poput yesterday, ako je dostupan; u protivnom rabi brojčani obrazac. style bira "long" (zadano), "short" ili "narrow". Podrška ovisi o izvršnom okruženju, a tekst se može razlikovati i uz iste jezične i regionalne postavke, primjerice po upotrebi neprelomivih razmaka. U prenosivim testovima ne uspoređuj rezultat s fiksno zadanim tekstom.

Metoda zahtijeva instancu kao this; odvojeni poziv bez valjanog this baca TypeError. Za povratni poziv upotrijebi formatter.format.bind(formatter). Nakon provjere this metoda primjenjuje ToNumber na value, a zatim ToString na unit. Primjerice, BigInt kao value uzrokuje TypeError. Nakon pretvorbe NaN, Infinity, -Infinity ili nepodržan identifikator jedinice uzrokuje RangeError.

Primjeri

{
  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"));
}

Rezultat

1 day ago
yesterday
true

Za isti pomak od `-1` dana prva dva retka prikazuju uobičajen engleski tekst za `"always"` i `"auto"`. Treći pokazuje da su `"day"` i `"days"` jednakovrijedni.

Povezane lekcije

  • JavaScript · Lekcija 24 · Napredno · Verzija: 4

Izvori