CKTIS / JavaScript
Intl.DateTimeFormat.prototype.format — formátování data a času podle místních zvyklostí
Pomocí `formatter.format()` zobrazíte datum a čas podle místního nastavení a časového pásma. Výsledkem je text určený k zobrazení, nikoli formát pro ukládání dat.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
const formatter = new Intl.DateTimeFormat(locales, options);
formatter.format(date);
formatter.format();
const format = formatter.format;
format(date);Volejte formatter.format(...) na instanci Intl.DateTimeFormat, nikoli na konstruktoru. Vytvořte formátovač pomocí new Intl.DateTimeFormat(locales, options) a zvolte místní nastavení, časové pásmo a pole, která se mají zobrazit. Volání vrátí řetězec a nemění objekt Date. Pokud vynecháte locales nebo timeZone, použije se odpovídající výchozí hodnota běhového prostředí.
V ECMA-402 (2024) předejte objekt Date nebo číselné časové razítko v milisekundách od unixové epochy, nikoli v sekundách. Bez argumentu nebo s hodnotou undefined se formátuje aktuální okamžik v době volání. format() neparsuje řetězce s datem: nejprve text převeďte na platný objekt Date nebo časové razítko. Neplatný Date, NaN, nekonečno nebo časové razítko mimo rozsah Date vyvolá RangeError.
Intl.DateTimeFormat.prototype.format je vlastnost s getterem. Přečtení formatter.format vrací stejnou funkci svázanou s danou instancí. Můžete ji tedy předat přímo jako zpětné volání, například v dates.map(formatter.format), bez volání bind().
Prostředí s integrací Temporal mohou formátovat také Temporal.PlainDateTime, Temporal.PlainDate, Temporal.PlainTime, Temporal.PlainYearMonth nebo Temporal.PlainMonthDay, pokud je typ kompatibilní s nastavením formátovače. Temporal.ZonedDateTime vyvolá TypeError; pro formátování hodnoty v jejím vlastním časovém pásmu použijte Temporal.ZonedDateTime.prototype.toLocaleString().
I při stejném nastavení se může výstup mezi prostředími lišit, například mezerami, interpunkcí nebo řídicími znaky směru textu. Neporovnávejte ho s textem zapsaným napevno a nepoužívejte ho jako formát pro výměnu dat.
Pří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ýsledek
string true
Příklad stanoví okamžik, místní nastavení a časové pásmo UTC. Kontroluje typ výsledku a to, zda samostatně volaná funkce formátuje časové razítko stejně jako volání na instanci s odpovídajícím objektem `Date`, aniž by předpokládal přesnou podobu textu.
Související lekce
- JavaScript · Lekce 15 · Základní · Verze: 4