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
- 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