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