CKTIS / JavaScript
Intl.RelativeTimeFormat — oblikovanje relativnog vremena
Intl.RelativeTimeFormat stvara lokalizirane opise relativnog vremena. Metoda format(value, unit) prima broj i jedinicu, a ne datum; izračun vremenske razlike ostaje odgovornost aplikacije.
Verzija: 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 dio je standarda internacionalizacije ECMA-402, a ne DOM API-ja. Instancu izradite pomoću new. RelativeTimeFormat.format ovdje označava metodu instance Intl.RelativeTimeFormat.prototype.format(value, unit), koja vraća tekst. Negativni brojevi opisuju prošlost, a pozitivni budućnost; metoda ne izračunava razlike između datuma.
unit prihvaća second, minute, hour, day, week, month, quarter, year i njihove engleske oblike množine. Nepodržana jedinica, NaN ili beskonačnost uzrokuju pogrešku RangeError.
Uz zadanu vrijednost numeric: "always" ne upotrebljavaju se posebni izrazi poput yesterday, ali obrazac za određenu jezičnu postavku može izraziti količinu bez izričitog navođenja broja. Primjerice, u arapskom jeziku oblik dvojine imenice može označavati dva dana bez zasebnog brojčanog dijela. numeric: "auto" dopušta izraze poput yesterday kada su dostupni. style prihvaća long (zadano), short ili narrow.
Primjer izričito odabire en i fiksne vrijednosti. Točan tekst ovisi o lokalizacijskim podacima. Provjerite jesu li konstruktor i tražena lokalizacija dostupni u ciljnom pregledniku; prisutnost Node 24 u repozitoriju ne dokazuje podršku preglednika.
Primjeri
const rtf = new Intl.RelativeTimeFormat("en", { numeric: "auto" });
console.log(rtf.format(-1, "day"));
console.log(rtf.format(1, "day"));Rezultat
yesterday tomorrow
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.