CKTIS / JavaScript
Intl.DateTimeFormat: de gebruikte opties opvragen
Gebruik `resolvedOptions()` om te zien welke datum- en tijdinstellingen een instantie echt gebruikt, zonder ze uit de argumenten van de constructor af te leiden.
Versie: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
formatter.resolvedOptions()Intl.DateTimeFormat.prototype.resolvedOptions is een instantiemethode zonder argumenten. Elke aanroep geeft een nieuw gewoon object terug met de instellingen die bij het aanmaken van de formatter zijn bepaald. Het resultaat aanpassen verandert de formatter niet. Anders dan format() neemt de methode geen datum aan en geeft ze geen opgemaakte tekst terug. Een ongebonden aanroep of een aanroep met een ongeschikte this, zoals {}, veroorzaakt een TypeError.
Het resultaat bevat locale (de werkelijk gekozen BCP 47-taaltag), calendar, numberingSystem en timeZone. Het is geen kopie van wat je aan de constructor doorgaf: de afstemming op beschikbare land- en taalinstellingen en de standaardwaarden kunnen het resultaat beïnvloeden. Zonder expliciete timeZone gebruikt de formatter de standaardtijdzone van de uitvoeromgeving op het moment van aanmaken. Een tijdzone-ID kan worden genormaliseerd en hoeft dus niet exact overeen te komen met de ingevoerde tekenreeks.
Zonder dateStyle of timeStyle weerspiegelen eigenschappen zoals year, month en hour het gekozen patroon; ongebruikte onderdelen worden weggelaten. Met dateStyle of timeStyle vermeldt het resultaat de opgegeven stijlen zonder ze uit te splitsen in afzonderlijke onderdelen. Een stijl combineren met een expliciete optie voor een onderdeel, zoals hour, veroorzaakt een TypeError in de constructor.
Als het patroon een uur bevat, bevat het resultaat hourCycle en de daarvan afgeleide hour12, ook wanneer timeStyle ervoor zorgt dat de eigenschap hour ontbreekt. hour12 is true voor h11 en h12, en false voor h23 en h24. Zonder uur ontbreken beide eigenschappen. Bij de keuze van de cyclus heeft de optie hour12 voorrang op hourCycle en de Unicode-extensie hc.
Gebruik het resultaat om verschillen tussen uitvoeromgevingen te onderzoeken. Ondersteunde opties en localegegevens kunnen verschillen, en dezelfde effectieve opties garanderen geen identieke opgemaakte tekst.
Voorbeelden
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);Resultaat
UTC short false false UTC
De code toont achtereenvolgens `UTC`, `short`, `false`, `false` en `UTC`. De eerste `false` staat voor 24-uursnotatie; de tweede geeft aan dat `hour` geen eigen eigenschap is. De toewijzing van `Asia/Tokyo` verandert alleen het teruggegeven object.
Gerelateerde lessen
- JavaScript · Les 25 · Gevorderd · Versie: 4
Bronnen
- 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