CKTIS / JavaScript
Intl.DateTimeFormat.prototype.format — oblikovanje datuma i vremena prema regionalnim postavkama
Upotrijebite `formatter.format()` za prikaz datuma i vremena prema regionalnim postavkama i vremenskoj zoni. Rezultat je tekst za prikaz, a ne format za pohranu podataka.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
const formatter = new Intl.DateTimeFormat(locales, options);
formatter.format(date);
formatter.format();
const format = formatter.format;
format(date);Pozovite formatter.format(...) na instanci objekta Intl.DateTimeFormat, a ne na konstruktoru. Izradite objekt za oblikovanje s pomoću new Intl.DateTimeFormat(locales, options) kako biste odabrali regionalne postavke, vremensku zonu i polja za prikaz. Poziv vraća znakovni niz i ne mijenja objekt Date. Ako izostavite locales ili timeZone, upotrebljava se odgovarajuća zadana vrijednost izvršnog okruženja.
U ECMA-402 (2024) proslijedite objekt Date ili brojčanu vremensku oznaku u milisekundama od Unixove epohe, ne u sekundama. Ako izostavite argument ili proslijedite undefined, oblikuje se trenutak u kojem je funkcija pozvana. format() ne tumači datumske nizove: tekst najprije pretvorite u valjani Date ili vremensku oznaku. Nevaljani Date, NaN, beskonačnost ili vremenska oznaka izvan raspona Date izaziva RangeError.
Intl.DateTimeFormat.prototype.format svojstvo je s getterom. Čitanje formatter.format vraća istu funkciju vezanu uz tu instancu. Zato je možete izravno proslijediti kao povratnu funkciju, primjerice u dates.map(formatter.format), bez poziva bind().
Okruženja s integracijom Temporal mogu oblikovati i Temporal.PlainDateTime, Temporal.PlainDate, Temporal.PlainTime, Temporal.PlainYearMonth ili Temporal.PlainMonthDay ako je tip kompatibilan s postavkama objekta za oblikovanje. Temporal.ZonedDateTime izaziva TypeError; upotrijebite Temporal.ZonedDateTime.prototype.toLocaleString() za oblikovanje vrijednosti u njezinoj vremenskoj zoni.
Čak i uz iste postavke, izlaz se može razlikovati među izvršnim okruženjima, primjerice po razmacima, interpunkciji ili dvosmjernim kontrolnim znakovima. Nemojte ga uspoređivati s unaprijed zadanim tekstom u kodu niti ga rabiti kao format za razmjenu podataka.
Primjeri
const formatter = new Intl.DateTimeFormat("en-GB", {
year: "numeric",
month: "long",
day: "numeric",
timeZone: "UTC",
});
const date = new Date("2024-06-15T00:00:00Z");
const format = formatter.format;
const text = formatter.format(date);
console.log(typeof text);
console.log(text === format(date.getTime()));Rezultat
string true
Primjer fiksira trenutak, regionalne postavke i vremensku zonu UTC. Provjerava tip rezultata i oblikuje li odvojeno pozvana funkcija vremensku oznaku jednako kao poziv na instanci s odgovarajućim objektom `Date`, bez pretpostavke o točnom tekstu.
Povezane lekcije
- JavaScript · Lekcija 15 · Osnovno · Verzija: 4