CKTIS / JavaScript
Intl.RelativeTimeFormat.prototype.format() — oblikovanje relativnega časa
Predznačeni časovni odmik in izrecno podano enoto pretvori v lokalizirano besedilo. Metoda sama ne izračuna razlike med datumoma.
Različica: 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 je metoda primerka. Klic formatter.format(value, unit) vrne niz glede na dejansko izbrane jezikovne in območne nastavitve ter možnosti, določene v konstruktorju. Aplikacija izračuna odmik od referenčne točke in izbere enoto; metoda ne odčitava ure in ne odšteva datumov.
Negativne vrednosti označujejo preteklost, pozitivne pa prihodnost. Pri številski predlogi -0 izbere predlogo za preteklost, +0 pa za prihodnost. unit sprejme natančne identifikatorje "second", "minute", "hour", "day", "week", "month", "quarter" in "year" ter njihove oblike s končnim s. Oblika identifikatorja ne določa slovnične oblike izpisa.
numeric: "always" (privzeto) uporablja številsko predlogo. numeric: "auto" uporabi poseben izraz, denimo yesterday, če je na voljo; sicer uporabi številsko predlogo. style omogoča izbiro med "long" (privzeto), "short" in "narrow". Podpora je odvisna od izvajalnega okolja. Tudi pri enakih jezikovnih in območnih nastavitvah se besedilo lahko razlikuje, denimo po uporabi nedeljivih presledkov. V prenosljivih testih rezultata ne primerjaj s fiksno zapisanim besedilom.
Metoda zahteva primerek kot this; ločen klic brez veljavnega this sproži TypeError. Za povratni klic uporabi formatter.format.bind(formatter). Po preverjanju this metoda nad value izvede ToNumber, nato nad unit še ToString. Na primer BigInt kot value sproži TypeError. Po pretvorbi NaN, Infinity, -Infinity ali nepodprt identifikator enote sproži RangeError.
Primeri
{
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
Pri istem odmiku `-1` dneva prvi dve vrstici prikazujeta običajno angleško besedilo za `"always"` in `"auto"`. Tretja pokaže, da sta `"day"` in `"days"` enakovredna.
Povezane lekcije
- JavaScript · Lekcija 24 · Napredna · Različica: 4
Viri
- 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