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

CKTIS / JavaScript

Intl.DateTimeFormat: preverjanje dejansko uporabljenih nastavitev

Z metodo `resolvedOptions()` preveriš, katere nastavitve za oblikovanje datuma in časa primerek dejansko uporablja, ne da bi jih sklepal iz argumentov konstruktorja.

Različica: ECMAScript 2024 and the current web platform; runtime support varies

Sintaksa

formatter.resolvedOptions()

Intl.DateTimeFormat.prototype.resolvedOptions je metoda primerka brez argumentov. Vsak klic vrne nov navaden objekt z nastavitvami, določenimi ob ustvarjanju oblikovalnika. Če spremeniš rezultat, ne spremeniš oblikovalnika. Za razliko od format() metoda ne sprejme datuma in ne vrne oblikovanega besedila. Klic brez vezave na primerek ali z nezdružljivo vrednostjo this, na primer {}, sproži TypeError.

Rezultat vsebuje locale (dejansko izbrano jezikovno oznako BCP 47), calendar, numberingSystem in timeZone. Ni kopija vhodnih podatkov konstruktorja: izbira med podprtimi jezikovnimi in območnimi nastavitvami ter privzete vrednosti lahko vplivajo na rezultat. Če timeZone ni izrecno podan, oblikovalnik ob ustvarjanju prevzame privzeti časovni pas izvajalnega okolja. Identifikator časovnega pasu se lahko normalizira, zato ni nujno enak vhodnemu nizu.

Brez dateStyle in timeStyle lastnosti, kot so year, month in hour, odražajo izbrani vzorec; neuporabljene sestavine so izpuščene. Če podaš dateStyle ali timeStyle, rezultat vsebuje zahtevane sloge, ne da bi jih razčlenil na posamezne sestavine. Kombinacija sloga z izrecno nastavitvijo sestavine, kot je hour, sproži TypeError že v konstruktorju.

Če vzorec vključuje uro, rezultat vsebuje hourCycle in iz njega izpeljani hour12, tudi če zaradi timeStyle v rezultatu ni lastnosti hour. hour12 je true za h11 in h12 ter false za h23 in h24. Če vzorec ne vključuje ure, sta obe lastnosti izpuščeni. Pri izbiri cikla ima možnost hour12 prednost pred hourCycle in razširitvijo Unicode hc.

Rezultat uporabi za ugotavljanje razlik med izvajalnimi okolji. Podpora za možnosti in lokalizacijski podatki se lahko razlikujejo, enake dejanske nastavitve pa ne zagotavljajo enakega oblikovanega besedila.

Primeri

const formatter = new Intl.DateTimeFormat("en-GB", {
  timeZone: "UTC",
  timeStyle: "short",
  hour12: false,
});
const options = formatter.resolvedOptions();

console.log(options.timeZone);
console.log(options.timeStyle);
console.log(options.hour12);
console.log(Object.hasOwn(options, "hour"));

options.timeZone = "Asia/Tokyo";
console.log(formatter.resolvedOptions().timeZone);

Rezultat

UTC
short
false
false
UTC

Koda po vrsti izpiše `UTC`, `short`, `false`, `false` in `UTC`. Prvi `false` pomeni 24-urni zapis, drugi pa pomeni, da `hour` ni lastna lastnost objekta. Prireditev `Asia/Tokyo` spremeni samo vrnjeni objekt.

Povezane lekcije

  • JavaScript · Lekcija 25 · Napredna · Različica: 4

Viri