CKTIS / JavaScript
Intl.DateTimeFormat: zjištění skutečně použitých voleb
Pomocí `resolvedOptions()` zjistíš, jaká nastavení instance skutečně používá k formátování data a času, místo abys je odvozoval z argumentů konstruktoru.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
formatter.resolvedOptions()Intl.DateTimeFormat.prototype.resolvedOptions je metoda instance bez argumentů. Při každém volání vrací nový běžný objekt s nastaveními určenými při vytvoření formátovače. Úprava výsledku formátovač nezmění. Na rozdíl od format() metoda nepřijímá datum ani nevrací naformátovaný text. Volání bez navázání na instanci nebo s nekompatibilním this, například {}, vyvolá TypeError.
Výsledek obsahuje locale (skutečně vybraný jazykový tag BCP 47), calendar, numberingSystem a timeZone. Není to kopie vstupu konstruktoru: výběr z podporovaných jazykových a místních nastavení i výchozí hodnoty mohou výsledek změnit. Bez explicitního timeZone formátovač při vytvoření převezme výchozí časové pásmo běhového prostředí. Identifikátor pásma může být normalizován, takže nemusí přesně odpovídat vstupnímu řetězci.
Bez dateStyle a timeStyle odrážejí vlastnosti jako year, month a hour vybraný vzor; nepoužité složky se vynechávají. S dateStyle nebo timeStyle výsledek uvádí zadané styly, ale nerozepisuje je na jednotlivé složky. Kombinace stylu s explicitní volbou složky, například hour, vyvolá TypeError už v konstruktoru.
Pokud vzor obsahuje hodinu, výsledek obsahuje hourCycle a z něj odvozené hour12, i když kvůli timeStyle chybí vlastnost hour. hour12 má hodnotu true pro h11 a h12 a false pro h23 a h24. Bez hodiny se obě vlastnosti vynechají. Při volbě cyklu má nastavení hour12 přednost před hourCycle i před rozšířením Unicode hc.
Výsledek využij při hledání příčin rozdílů mezi běhovými prostředími. Podpora voleb a lokalizační data se mohou lišit a shodné výsledné volby nezaručují totožný naformátovaný text.
Pří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ýsledek
UTC short false false UTC
Kód postupně vypíše `UTC`, `short`, `false`, `false` a `UTC`. První `false` značí 24hodinový formát, druhé značí, že `hour` není vlastní vlastností objektu. Přiřazení `Asia/Tokyo` změní pouze vrácený objekt.
Související lekce
- JavaScript · Lekce 25 · Pokročilá · Verze: 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