CKTIS / JavaScript
Intl.DateTimeFormat.prototype.format — formátovanie dátumu a času podľa miestnych zvyklostí
Pomocou `formatter.format()` zobrazíte dátum a čas podľa miestnych nastavení a časového pásma. Výsledkom je text na zobrazenie, nie formát na ukladanie údajov.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
const formatter = new Intl.DateTimeFormat(locales, options);
formatter.format(date);
formatter.format();
const format = formatter.format;
format(date);Volajte formatter.format(...) na inštancii Intl.DateTimeFormat, nie na konštruktore. Vytvorte formátovač pomocou new Intl.DateTimeFormat(locales, options) a vyberte miestne nastavenia, časové pásmo a polia, ktoré sa majú zobraziť. Volanie vráti reťazec a nemení objekt Date. Ak vynecháte locales alebo timeZone, použije sa príslušná predvolená hodnota prostredia vykonávania.
V ECMA-402 (2024) odovzdajte objekt Date alebo číselnú časovú pečiatku v milisekundách od unixovej epochy, nie v sekundách. Bez argumentu alebo s hodnotou undefined sa formátuje aktuálny okamih v čase volania. format() nespracúva textové zápisy dátumu ako dátumy: text najprv preveďte na platný objekt Date alebo časovú pečiatku. Neplatný Date, NaN, nekonečno alebo časová pečiatka mimo rozsahu Date vyvolá RangeError.
Intl.DateTimeFormat.prototype.format je vlastnosť s getterom. Čítanie formatter.format vráti tú istú funkciu viazanú na danú inštanciu. Môžete ju preto odovzdať priamo ako spätné volanie, napríklad v dates.map(formatter.format), bez volania bind().
Prostredia s integráciou Temporal môžu formátovať aj Temporal.PlainDateTime, Temporal.PlainDate, Temporal.PlainTime, Temporal.PlainYearMonth alebo Temporal.PlainMonthDay, ak je typ kompatibilný s nastaveniami formátovača. Temporal.ZonedDateTime vyvolá TypeError; na formátovanie hodnoty v jej vlastnom časovom pásme použite Temporal.ZonedDateTime.prototype.toLocaleString().
Aj pri rovnakých nastaveniach sa výstup môže medzi prostrediami líšiť, napríklad medzerami, interpunkciou alebo riadiacimi znakmi smeru textu. Neporovnávajte ho s textom zapísaným napevno ani ho nepoužívajte ako formát na výmenu údajov.
Príklady
const formatter = new Intl.DateTimeFormat("en-GB", {
year: "numeric",
month: "long",
day: "numeric",
timeZone: "UTC",
});
const date = new Date("2024-06-15T00:00:00Z");
const format = formatter.format;
const text = formatter.format(date);
console.log(typeof text);
console.log(text === format(date.getTime()));Výsledok
string true
Príklad určuje okamih, miestne nastavenia aj časové pásmo UTC. Overuje typ výsledku a to, či samostatne volaná funkcia formátuje časovú pečiatku rovnako ako volanie na inštancii so zodpovedajúcim objektom `Date`, bez predpokladu o presnej podobe textu.
Súvisiace lekcie
- JavaScript · Lekcia 15 · Základná · Verzia: 4