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

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

Zdroje