Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Intl.RelativeTimeFormat — oblikovanje relativnega časa

Intl.RelativeTimeFormat ustvarja lokalizirane opise relativnega časa. Metoda format(value, unit) sprejme število in enoto, ne datuma; izračun časovne razlike ostaja naloga aplikacije.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

const rtf = new Intl.RelativeTimeFormat(locales, { numeric: "auto", style: "long" });
rtf.format(value, unit);

Intl.RelativeTimeFormat spada v standard internacionalizacije ECMA-402, ne med API-je DOM. Primerek ustvarite z new. RelativeTimeFormat.format tukaj označuje metodo primerka Intl.RelativeTimeFormat.prototype.format(value, unit), ki vrne besedilo. Negativna števila opisujejo preteklost, pozitivna pa prihodnost; metoda ne izračunava razlik med datumi.

unit sprejema second, minute, hour, day, week, month, quarter, year in njihove angleške množinske oblike. Nepodprta enota, NaN ali neskončnost povzročijo napako RangeError.

Pri privzeti vrednosti numeric: "always" se posebni izrazi, kot je yesterday, ne uporabljajo, vendar lahko vzorec za dano jezikovno nastavitev izrazi količino, ne da bi izrecno navedel število. V arabščini lahko na primer dvojinska oblika samostalnika označuje dva dneva brez ločenega številskega dela. numeric: "auto" omogoča izraze, kot je yesterday, kadar so na voljo. style sprejema long (privzeto), short ali narrow.

Primer izrecno izbere en in fiksne vrednosti. Natančno besedilo je odvisno od lokalizacijskih podatkov. Preverite, ali sta konstruktor in zahtevana lokalizacija na voljo v ciljnem brskalniku; prisotnost Node 24 v repozitoriju ne dokazuje podpore v brskalniku.

Primeri

const rtf = new Intl.RelativeTimeFormat("en", { numeric: "auto" });
console.log(rtf.format(-1, "day"));
console.log(rtf.format(1, "day"));

Rezultat

yesterday
tomorrow

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri