CKTIS / JavaScript
Intl.DateTimeFormat: zistenie skutočne použitých nastavení
Pomocou `resolvedOptions()` zistíš, aké nastavenia inštancia skutočne používa pri formátovaní dátumu a času, bez odvodzovania z argumentov konštruktora.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
formatter.resolvedOptions()Intl.DateTimeFormat.prototype.resolvedOptions je metóda inštancie bez argumentov. Každé volanie vráti nový obyčajný objekt s nastaveniami, ktoré sa určili pri vytvorení formátovača. Úprava výsledku formátovač nezmení. Na rozdiel od format() metóda neprijíma dátum ani nevracia formátovaný text. Volanie bez naviazania na inštanciu alebo s nekompatibilným this, napríklad {}, vyvolá TypeError.
Výsledok obsahuje locale (skutočne vybranú jazykovú značku BCP 47), calendar, numberingSystem a timeZone. Nie je to kópia vstupu konštruktora: výber z podporovaných jazykových a miestnych nastavení aj predvolené hodnoty môžu výsledok zmeniť. Bez explicitného timeZone formátovač pri vytvorení prevezme predvolené časové pásmo prostredia vykonávania. Identifikátor pásma sa môže normalizovať, takže nemusí presne zodpovedať vstupnému reťazcu.
Bez dateStyle a timeStyle vlastnosti ako year, month a hour odrážajú vybraný vzor; nepoužité zložky sa vynechávajú. S dateStyle alebo timeStyle výsledok uvádza zadané štýly, ale nerozpisuje ich na jednotlivé zložky. Kombinácia štýlu s explicitnou voľbou zložky, napríklad hour, vyvolá TypeError už v konštruktore.
Ak vzor obsahuje hodinu, výsledok obsahuje hourCycle a z neho odvodené hour12, aj keď pre timeStyle chýba vlastnosť hour. hour12 má hodnotu true pre h11 a h12 a false pre h23 a h24. Bez hodiny sa obidve vlastnosti vynechajú. Pri výbere cyklu má voľba hour12 prednosť pred hourCycle a rozšírením Unicode hc.
Výsledok použi pri zisťovaní príčin rozdielov medzi prostrediami vykonávania. Podpora volieb aj lokalizačné údaje sa môžu líšiť a rovnaké výsledné nastavenia nezaručujú rovnaký formátovaný text.
Príklady
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);Výsledok
UTC short false false UTC
Kód postupne vypíše `UTC`, `short`, `false`, `false` a `UTC`. Prvé `false` označuje 24-hodinový formát, druhé znamená, že `hour` nie je vlastnou vlastnosťou objektu. Priradenie `Asia/Tokyo` zmení len vrátený objekt.
Súvisiace lekcie
- JavaScript · Lekcia 25 · Pokročilá · Verzia: 4
Zdroje
- ECMAScript® 2024 Internationalization API Specification — Intl.DateTimeFormat.prototype.resolvedOptions
- ECMAScript Internationalization API Specification (living draft) — Intl.DateTimeFormat.prototype.resolvedOptions
- ECMAScript Internationalization API Specification (living draft) — CreateDateTimeFormat