Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Intl.DateTimeFormat.formatToParts(): časti dátumu a času

Získaj jednotlivé časti lokalizovaného dátumu alebo času a uprav ich vzhľad bez odhadovania poradia polí či delenia textu podľa interpunkcie.

Verzia: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

formatter.formatToParts()
formatter.formatToParts(date)

Intl.DateTimeFormat.prototype.formatToParts je metóda inštancie Intl.DateTimeFormat. Namiesto jediného reťazca, ktorý vracia format(), dostaneš pole objektov { type, value } v poradí zobrazenia. Obe vlastnosti sú reťazce. Spojením všetkých hodnôt value pomocou join("") získaš výsledok format() pre rovnaký formátovač a vstup. Na rozdiel od funkcie, ktorú vracia vlastnosť format, sa formatToParts automaticky neviaže na inštanciu. Ako spätné volanie odovzdaj date => formatter.formatToParts(date) alebo použi bind; nekompatibilné this vyvolá TypeError.

Časti vyberaj podľa type, napríklad month alebo dayPeriod, nie podľa indexu v poli. Zachovaj časti literal: môžu obsahovať medzery, interpunkciu alebo slová. V niektorých kalendároch sa namiesto year objaví relatedYear (zodpovedajúci gregoriánsky rok), niekedy spolu s yearName (názvom roka). Zachovaj aj neznáme časti. Výsledok môžu ovplyvniť miestne nastavenia, voľby a údaje prostredia. Časti používaj na zobrazenie, nie na parsovanie ani ukladanie. V prehliadači vkladaj hodnoty ako text pomocou textContent, nie cez innerHTML.

V ECMA-402 pre ECMAScript 2024 odovzdaj objekt Date alebo počet milisekúnd od unixovej epochy. Metóda konvertuje argument na číslo; neinterpretuje reťazce ako dátumy. Ak argument vynecháš alebo odovzdáš undefined, použije aktuálny čas v okamihu volania. Neplatný Date alebo časová značka mimo rozsahu vyvolá RangeError.

Prostredia s integráciou Temporal prijímajú aj Temporal.Instant a typy Temporal.Plain* určené pre túto metódu, s obmedzeniami kalendára a formátovania podľa typu. Over podporu v cieľovom prostredí. Priame odovzdanie Temporal.ZonedDateTime vyvolá TypeError. Ak chceš časti toho istého okamihu v jeho časovom pásme, odovzdaj výsledok toInstant() a nastav timeZone formátovača na pásmo tohto objektu.

Prí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ýsledok

true
true

Príklad pevne nastavuje okamih, miestne nastavenia a pásmo UTC. Prvé `true` potvrdzuje prítomnosť časti `month`. Druhé potvrdzuje, že spojené hodnoty zodpovedajú `format(date)` bez predpokladu o konkrétnych oddeľovačoch.

Súvisiace lekcie

  • JavaScript · Lekcia 25 · Pokročilá · Verzia: 4

Zdroje