CKTIS / JavaScript
Intl.DateTimeFormat.prototype.format — форматиране на дата и час според регионалните настройки
Използвайте `formatter.format()`, за да покажете дата и час според регионалните настройки и часовата зона. Резултатът е текст за показване, а не формат за съхранение на данни.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
const formatter = new Intl.DateTimeFormat(locales, options);
formatter.format(date);
formatter.format();
const format = formatter.format;
format(date);Извикайте formatter.format(...) върху инстанция на Intl.DateTimeFormat, а не върху конструктора. Създайте форматиращ обект с new Intl.DateTimeFormat(locales, options), за да изберете регионалните настройки, часовата зона и полетата за показване. Извикването връща низ и не променя обекта Date. Ако пропуснете locales или timeZone, се използва съответната стойност по подразбиране на средата за изпълнение.
В ECMA-402 (2024) подайте обект Date или числово клеймо за време в милисекунди от началото на епохата Unix, не в секунди. Ако пропуснете аргумента или подадете undefined, се форматира текущият момент при извикването. format() не разпознава дати в текстови низове: първо преобразувайте текста във валиден Date или числово клеймо за време. Невалиден Date, NaN, безкрайност или клеймо за време извън обхвата на Date предизвиква RangeError.
Intl.DateTimeFormat.prototype.format е свойство с getter. Прочитането на formatter.format връща същата функция, обвързана с тази инстанция. Затова можете да я подадете директно като функция за обратно извикване, например в dates.map(formatter.format), без да извиквате bind().
Средите с интеграция на Temporal могат да форматират и Temporal.PlainDateTime, Temporal.PlainDate, Temporal.PlainTime, Temporal.PlainYearMonth или Temporal.PlainMonthDay, ако типът е съвместим с настройките на форматиращия обект. Temporal.ZonedDateTime предизвиква TypeError; използвайте Temporal.ZonedDateTime.prototype.toLocaleString(), за да форматирате стойността в собствената ѝ часова зона.
Дори при еднакви настройки резултатът може да се различава между средите, например по интервали, препинателни знаци или управляващи знаци за посоката на текста. Не го сравнявайте с твърдо зададен текст и не го използвайте като формат за обмен на данни.
Примери
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()));Резултат
string true
Примерът задава конкретен момент, регионални настройки и часова зона UTC. Той проверява типа на резултата и дали отделно извиканата функция форматира числовото клеймо за време по същия начин като извикването върху инстанцията със съответния `Date`, без да предполага точния текст.
Свързани уроци
- JavaScript · Урок 15 · Начално · Версия: 4