Intl.DurationFormat

Объект Intl.DurationFormat позволяет выполнять форматирование длительности с учетом языка.

Конструктор

Intl.DurationFormat()

Создает новый объект Intl.DurationFormat.

Статические методы

Intl.DurationFormat.supportedLocalesOf()

Возвращает массив, содержащий те из предоставленных локалей, которые поддерживаются без необходимости отката к локали по умолчанию.

Свойства экземпляра

Эти свойства определены в Intl.DurationFormat.prototype и используются совместно всеми экземплярами Intl.DurationFormat.

Intl.DurationFormat.prototype.constructor

Конструктор, создавший объект экземпляра. Для экземпляров Intl.DurationFormat начальным значением является конструктор Intl.DurationFormat.

Intl.DurationFormat.prototype[Symbol.toStringTag]

Начальное значение свойства [Symbol.toStringTag] — строка "Intl.DurationFormat". Это свойство используется в Object.prototype.toString().

Методы экземпляра

Intl.DurationFormat.prototype.format()

Функция-геттер, которая форматирует длительность в соответствии с локалью и параметрами форматирования данного объекта DurationFormat.

Intl.DurationFormat.prototype.formatToParts()

Возвращает Array объектов, представляющих отформатированную длительность по частям.

Intl.DurationFormat.prototype.resolvedOptions()

Возвращает новый объект со свойствами, отражающими локаль и параметры форматирования, вычисленные при инициализации объекта.

Примеры

Использование Intl.DurationFormat

Примеры ниже показывают, как использовать объект Intl.DurationFormat для форматирования объекта длительности с различными локалями и стилями.

const duration = {
  hours: 1,
  minutes: 46,
  seconds: 40,
};

// With style set to "long" and locale "fr-FR"
new Intl.DurationFormat("fr-FR", { style: "long" }).format(duration);
// "1 heure, 46 minutes et 40 secondes"

// With style set to "short" and locale "en"
new Intl.DurationFormat("en", { style: "short" }).format(duration);
// "1 hr, 46 min and 40 sec"

// With style set to "narrow" and locale "pt"
new Intl.DurationFormat("pt", { style: "narrow" }).format(duration);
// "1 h 46 min 40 s"

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

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

См. также

• Полифил Intl.DurationFormat в FormatJS
• Intl
• Temporal.Duration.prototype.toLocaleString()