Intl.DateTimeFormat.prototype.format

Сводка

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

Синтаксис

dateTimeFormat.format(date)

Параметры

date

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

Описание

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

Примеры

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

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

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() напрямую.

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"

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

Спецификация Статус Комментарии
ECMAScript Internationalization API 1.0 (ECMA-402)
Определение 'Intl.DateTimeFormat.format' в этой спецификации.
Стандарт Изначальное определение.

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

BCD tables only load in the browser

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