Intl.DateTimeFormat.prototype.format

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.

Сводка

Свойство Intl.DateTimeFormat.prototype.format возвращает функцию-геттер, форматирующую дату согласно локали и параметрам форматирования соответствующего объекта DateTimeFormat.

Синтаксис

dateTimeFormat.format(date)

Параметры

date

Дата для форматирования.

Описание

Функция, возвращённая геттером format, форматирует дату согласно локали и параметрам форматирования соответствующего объекта DateTimeFormat.

Примеры

Пример: использование функции format

Использование функции, возвращённой геттером format, для форматирования одной даты, здесь пример для сербского языка:

js
var options = {
  weekday: "long",
  year: "numeric",
  month: "long",
  day: "numeric",
};
var dateTimeFormat = new Intl.DateTimeFormat("sr-RS", options);
console.log(dateTimeFormat.format(new Date()));
// → "недеља, 7. април 2013."

Пример: использование функции format вместе с map

Использование функции, возвращённой геттером format, для форматирования всех дат в массиве. Обратите внимание, что функция привязана к объекту DateTimeFormat, из которого она была получена, так что её можно передавать в Array.prototype.map() напрямую.

js
var a = [new Date(2012, 08), new Date(2012, 11), new Date(2012, 03)];
var options = { year: "numeric", month: "long" };
var dateTimeFormat = new Intl.DateTimeFormat("pt-BR", options);
var formatted = a.map(dateTimeFormat.format);
console.log(formatted.join("; "));
// → "setembro de 2012; dezembro de 2012; abril de 2012"

Спецификации

Specification
ECMAScript Internationalization API Specification
# sec-intl.datetimeformat.prototype.format

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также