CKTIS / JavaScript
Intl.DateTimeFormat.formatToParts(): části data a času
Získej jednotlivé části lokalizovaného data nebo času a uprav jejich vzhled bez odhadování pořadí polí nebo dělení textu podle interpunkce.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
formatter.formatToParts()
formatter.formatToParts(date)Intl.DateTimeFormat.prototype.formatToParts je metoda instance Intl.DateTimeFormat. Místo jediného řetězce, který vrací format(), dostaneš pole objektů { type, value } v pořadí zobrazení. Obě vlastnosti jsou řetězce. Spojením všech hodnot value pomocí join("") získáš výsledek format() pro stejný formátovač a vstup. Na rozdíl od funkce vrácené vlastností format není formatToParts automaticky svázaná s instancí. Jako zpětné volání předej date => formatter.formatToParts(date) nebo použij bind; nekompatibilní this vyvolá TypeError.
Části vybírej podle type, například month nebo dayPeriod, ne podle indexu v poli. Zachovej části literal: mohou obsahovat mezery, interpunkci nebo slova. V některých kalendářích se místo year objeví relatedYear (odpovídající gregoriánský rok), někdy spolu s yearName (názvem roku). Zachovej i neznámé části. Výsledek může záviset na jazykovém nastavení, volbách i datech běhového prostředí. Části používej k zobrazení, ne k parsování ani ukládání. V prohlížeči vkládej hodnoty jako text pomocí textContent, ne přes innerHTML.
V ECMA-402 pro ECMAScript 2024 předej objekt Date nebo počet milisekund od unixové epochy. Metoda převádí argument na číslo; neinterpretuje řetězce jako data. Při vynechání argumentu nebo předání undefined použije aktuální čas v okamžiku volání. Neplatný Date nebo časová značka mimo rozsah vyvolá RangeError.
Prostředí s integrací Temporal přijímají také Temporal.Instant a typy Temporal.Plain* specifikované pro tuto metodu, s omezeními kalendáře a formátování podle typu. Ověř podporu v cílovém prostředí. Přímé předání Temporal.ZonedDateTime vyvolá TypeError. Pro části téhož okamžiku v jeho časovém pásmu předej výsledek toInstant() a nastav timeZone formátovače na pásmo tohoto objektu.
Příklady
{
const formatter = new Intl.DateTimeFormat("en-US", {
timeZone: "UTC",
calendar: "gregory",
year: "numeric",
month: "long",
day: "numeric",
});
const date = new Date("2024-07-05T12: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ě nastavuje okamžik, jazykové nastavení a pásmo UTC. První `true` potvrzuje přítomnost části `month`. Druhé potvrzuje, že spojené hodnoty odpovídají `format(date)`, aniž by se předpokládaly konkrétní oddělovače.
Související lekce
- JavaScript · Lekce 25 · Pokročilá · Verze: 4