База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

Intl.DateTimeFormat — локализирано форматиране на дата и час

Intl.DateTimeFormat форматира дати и часове според локалните конвенции и избрана часова зона. Научете за format(), formatToParts(), resolvedOptions() и разликата между timeZone и hourCycle.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

const formatter = new Intl.DateTimeFormat(locales, options);
formatter.format(date);
formatter.formatToParts(date);
formatter.resolvedOptions();

Intl.DateTimeFormat е част от стандарта за интернационализация ECMA-402, а не от DOM API. Създайте форматер с new Intl.DateTimeFormat(locales, options) и го използвайте повторно. Локалът определя конвенциите за представяне; той не избира автоматично часовата зона, съответстваща на тази държава.

Имената Intl.DateTimeFormat.format и Intl.DateTimeFormat.formatToParts тук означават операции върху екземпляр, а не статични методи на конструктора. formatter.format(date) връща текст; свойството format е аксесор, който предоставя обвързана функция. formatter.formatToParts(date) връща подредени обекти { type, value }, включително части literal. Свързването на всички стойности value възстановява format(date). Не парсвайте локализиран текст чрез разделяне по разделители.

timeZone, например UTC или Europe/Warsaw, избира зоната за показване на същия момент, без да променя обекта Date. Ако пропуснете опцията, се използва часовата зона на средата. hourCycle избира диапазона на часовете: h11 е 0–11, h12 е 1–12, h23 е 0–23, а h24 е 1–24. Тя има значение при форматиране на часове; ако е зададена опцията hour12, тя има предимство.

Intl.DateTimeFormat.prototype.resolvedOptions, извикан като formatter.resolvedOptions(), показва действително избраните настройки, включително locale, timeZone и, когато форматът включва часове, hourCycle. Данните за локалите може да се различават между средите, затова не приемайте, че пунктуацията или интервалите са еднакви. Стандартът не е таблица за съвместимост на браузърите: проверете необходимите методи и опции в целевите среди; Node 24 не доказва поддръжка в браузърите.

Примери

const formatter = new Intl.DateTimeFormat('en-GB', {
  timeZone: 'UTC',
  numberingSystem: 'latn',
  hour: '2-digit',
  minute: '2-digit',
  hourCycle: 'h23'
});
const date = new Date('2024-01-02T00:05:00Z');
const parts = formatter.formatToParts(date);
const field = type => parts.find(part => part.type === type).value;
console.log(`${field('hour')}:${field('minute')}`);
console.log(parts.map(part => part.value).join('') === formatter.format(date));
console.log(formatter.resolvedOptions().hourCycle);

Резултат

00:05
true
h23

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници