CKTIS / JavaScript
Intl.DateTimeFormat.prototype.format — oblikovanje datuma in časa po krajevnih nastavitvah
Z `formatter.format()` prikažete datum in čas glede na krajevne nastavitve in časovni pas. Rezultat je besedilo za prikaz, ne oblika za shranjevanje podatkov.
Različica: 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);formatter.format(...) pokličite na primerku Intl.DateTimeFormat, ne na konstruktorju. Z new Intl.DateTimeFormat(locales, options) ustvarite oblikovalnik ter izberete krajevne nastavitve, časovni pas in polja za prikaz. Klic vrne niz in ne spremeni objekta Date. Če izpustite locales ali timeZone, oblikovalnik uporabi ustrezno privzeto vrednost okolja izvajanja.
V ECMA-402 (2024) podajte objekt Date ali številski časovni žig v milisekundah od začetka Unixove epohe, ne v sekundah. Brez argumenta ali z vrednostjo undefined se oblikuje trenutni čas ob klicu. format() ne razčlenjuje datumskih nizov: besedilo najprej pretvorite v veljaven objekt Date ali časovni žig. Neveljaven Date, NaN, neskončnost ali časovni žig zunaj obsega Date sproži RangeError.
Intl.DateTimeFormat.prototype.format je lastnost z dostopno funkcijo (getterjem). Branje formatter.format vrne isto funkcijo, vezano na ta primerek. Zato jo lahko neposredno podate kot povratni klic, na primer v dates.map(formatter.format), ne da bi klicali bind().
Okolja z integracijo Temporal lahko oblikujejo tudi Temporal.PlainDateTime, Temporal.PlainDate, Temporal.PlainTime, Temporal.PlainYearMonth ali Temporal.PlainMonthDay, če je tip združljiv z nastavitvami oblikovalnika. Temporal.ZonedDateTime sproži TypeError; za oblikovanje vrednosti v njenem časovnem pasu uporabite Temporal.ZonedDateTime.prototype.toLocaleString().
Tudi pri enakih nastavitvah se lahko rezultat med okolji razlikuje, na primer v presledkih, ločilih ali kontrolnih znakih za smer besedila. Ne primerjajte ga z vnaprej zapisanim besedilom in ga ne uporabljajte kot obliko za izmenjavo podatkov.
Primeri
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
Primer določi trenutek, krajevne nastavitve in časovni pas UTC. Preveri tip rezultata in ali ločeno klicana funkcija oblikuje časovni žig enako kot klic na primerku z ustreznim objektom `Date`, ne da bi predpostavljal natančno besedilo.
Povezane lekcije
- JavaScript · Lekcija 15 · Osnovna · Različica: 4