CKTIS / JavaScript
Intl.DateTimeFormat: získání částí data pomocí formatToParts()
Získejte části lokalizovaného data nebo času, abyste mohli zvýraznit třeba měsíc bez rozdělování textu podle oddělovačů a bez předpokladu pevného pořadí polí.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
formatter.formatToParts()
formatter.formatToParts(date)formatToParts() je metoda instance Intl.DateTimeFormat definovaná na Intl.DateTimeFormat.prototype, nikoli statická metoda konstruktoru. Volejte ji jako formatter.formatToParts(date). Na rozdíl od format() není automaticky svázána s instancí: volání samostatně uložené funkce bez správné hodnoty this vyvolá TypeError.
Předejte objekt Date nebo časovou značku v milisekundách od unixové epochy, nikoli v sekundách. Při vynechání argumentu nebo předání undefined se použije aktuální čas z Date.now(). Neplatný Date nebo časová značka mimo rozsah vyvolá RangeError. Metoda formátuje hodnoty, nečte datum z textu. Prostředí s integrací Temporal mohou přijímat také některé typy Temporal.Plain*; přímé předání Temporal.ZonedDateTime vyvolá TypeError.
Výsledkem je pole objektů { type, value } v pořadí zobrazení; obě vlastnosti jsou řetězce. Hodnota type jako month, day nebo year označuje pole. literal označuje text ze vzoru, například čárku, mezeru nebo slovo. V kalendářích s pojmenovanými roky může relatedYear (odpovídající gregoriánský rok) nahradit year; vzor může obsahovat i yearName (název roku).
Vybírejte části podle type, nikoli podle indexu v poli. Chcete-li získat stejný výsledek jako z format() pro tutéž instanci a totéž datum, spojte všechny řetězce value bez oddělovače, včetně částí typu literal. Výsledek ovlivňují místní nastavení a volby jako kalendář a časové pásmo. Přesný zápis a interpunkce se mohou mezi prostředími lišit i při stejném místním nastavení. Nepoužívejte výsledek jako formát pro výměnu dat.
Pří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ýsledek
true true
Příklad pevně stanoví datum, místní nastavení a časové pásmo UTC. První `true` potvrzuje přítomnost části `month`; druhé potvrzuje, že spojené hodnoty odpovídají výsledku `format()`.
Související lekce
- JavaScript · Lekce 15 · Základní · Verze: 4