Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje