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® 2025 Internationalization API Specification
# sec-intl.datetimeformat.prototype.format

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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
format

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
See implementation notes.

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