CKTIS / JavaScript
Intl.DateTimeFormat: získanie častí dátumu pomocou formatToParts()
Získajte časti lokalizovaného dátumu alebo času, aby ste mohli zvýrazniť napríklad mesiac bez rozdeľovania textu podľa oddeľovačov a bez predpokladu pevného poradia polí.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
formatter.formatToParts()
formatter.formatToParts(date)formatToParts() je metóda inštancie Intl.DateTimeFormat definovaná na Intl.DateTimeFormat.prototype, nie statická metóda konštruktora. Volajte ju ako formatter.formatToParts(date). Na rozdiel od format() sa automaticky neviaže na inštanciu: volanie samostatne uloženej funkcie bez správnej hodnoty this vyvolá TypeError.
Odovzdajte objekt Date alebo časovú značku v milisekundách od unixovej epochy, nie v sekundách. Pri vynechaní argumentu alebo odovzdaní undefined sa použije aktuálny čas z Date.now(). Neplatný Date alebo časová značka mimo rozsahu vyvolá RangeError. Metóda formátuje hodnoty, nečíta dátum z textu. Prostredia s integráciou Temporal môžu prijímať aj niektoré typy Temporal.Plain*; priame odovzdanie Temporal.ZonedDateTime vyvolá TypeError.
Výsledkom je pole objektov { type, value } v poradí zobrazenia; obe vlastnosti sú reťazce. Hodnota type ako month, day alebo year označuje pole. literal označuje text zo vzoru, napríklad čiarku, medzeru alebo slovo. V kalendároch s pomenovanými rokmi môže relatedYear (zodpovedajúci gregoriánsky rok) nahradiť year; vzor môže obsahovať aj yearName (názov roka).
Vyberajte časti podľa type, nie podľa indexu v poli. Ak chcete získať rovnaký výsledok ako z format() pri rovnakej inštancii a rovnakom dátume, spojte všetky reťazce value bez oddeľovača vrátane častí typu literal. Výsledok ovplyvňujú miestne nastavenia a voľby ako kalendár a časové pásmo. Presný zápis a interpunkcia sa môžu líšiť medzi prostrediami aj pri rovnakých miestnych nastaveniach. Nepoužívajte výsledok ako formát na výmenu údajov.
Príklady
const formatter = new Intl.DateTimeFormat("en-US", {
timeZone: "UTC",
year: "numeric",
month: "long",
day: "numeric",
});
const date = new Date("2024-07-09T12:00:00Z");
const parts = formatter.formatToParts(date);
console.log(parts.some(({ type }) => type === "month"));
console.log(parts.map(({ value }) => value).join("") === formatter.format(date));Výsledok
true true
Príklad pevne stanovuje dátum, miestne nastavenia a časové pásmo UTC. Prvé `true` potvrdzuje prítomnosť časti `month`; druhé potvrdzuje, že spojené hodnoty zodpovedajú výsledku `format()`.
Súvisiace lekcie
- JavaScript · Lekcia 15 · Základná · Verzia: 4