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.