Intl

Инструменты для интернационализации и локализации. Создавайте приложения с поддержкой языков, форматируйте даты и время и адаптируйте содержимое для разных локалей.

Например, Intl

интерфейс Intl.DateTimeFormat

нестабильный

Методы

format(date?: Formattable | number): string

Форматирует дату в строку согласно локали и параметрам форматирования этого объекта Intl.DateTimeFormat.

formatToParts(date?: Formattable | number): globalThis.Intl.DateTimeFormatPart[]

Позволяет выполнять форматирование с учетом локали строк, созданных форматтерами Intl.DateTimeFormat.

formatRange<T extends Formattable>(

startDate: T,

endDate: T,
): string

Форматирует диапазон дат наиболее кратким способом с учетом локали и параметров, заданных при создании этого объекта Intl.DateTimeFormat.

formatRange(

startDate: Date | number,

endDate: Date | number,
): string

formatRangeToParts<T extends Formattable>(

startDate: T,

endDate: T,
): DateTimeFormatRangePart[]

Позволяет выполнять форматирование с учетом локали токенов, представляющих каждую часть отформатированного диапазона дат, созданного форматтерами Intl.DateTimeFormat.

formatRangeToParts(

startDate: Date | number,

endDate: Date | number,
): DateTimeFormatRangePart[]

интерфейс Intl.DateTimeFormatOptions

нестабильный

Свойства

dayPeriod: 
"narrow"
 | "short"
 | "long"

необязательное

dateStyle: 
"full"
 | "long"
 | "medium"
 | "short"

необязательное

timeStyle: 
"full"
 | "long"
 | "medium"
 | "short"

необязательное

интерфейс Intl.DateTimeFormatRangePart

нестабильный

Представляет часть отформатированного диапазона дат, созданного методом Intl.DateTimeFormat.formatRange().

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

Примеры

const dtf = new Intl.DateTimeFormat('en', {
  dateStyle: 'long',
  timeStyle: 'short'
});
const parts = dtf.formatRangeToParts(
  new Date(2023, 0, 1, 12, 0),
  new Date(2023, 0, 3, 15, 30)
);
console.log(parts);
// Parts might include elements like:
// { type: 'month', value: 'January', source: 'startRange' }
// { type: 'day', value: '1', source: 'startRange' }
// { type: 'literal', value: ' - ', source: 'shared' }
// { type: 'day', value: '3', source: 'endRange' }
// ...

Свойства

type: string

Тип компонента даты или времени, который представляет эта часть. Возможные значения: 'day', 'dayPeriod', 'era', 'fractionalSecond', 'hour', 'literal', 'minute', 'month', 'relatedYear', 'second', 'timeZoneName', 'weekday', 'year' и т. д.

value: string

Строковое значение этой части.

source: 
"shared"
 | "startRange"
 | "endRange"

Указывает, к какой дате в диапазоне относится эта часть.

'startRange': часть относится к начальной дате
'endRange': часть относится к конечной дате
'shared': часть является общей для обеих дат (например, разделители)

интерфейс Intl.Locale

Дополняет стандартный интерфейс Intl.Locale членами, которые пока отсутствуют в определениях библиотеки TypeScript, входящей в комплект поставки.

Свойства

variants: string | undefined

только для чтения

Возвращает подтеги вариантов локали в виде одной строки, разделяя подтеги с помощью -. Возвращает undefined, если у локали нет подтегов вариантов.

Справочник MDN

пространство имен Intl

Пространство имен Intl объединяет конструкторы и функции API интернационализации ECMAScript.

Это объявление дополняет стандартное пространство имен Intl членами, которые пока не входят в определения библиотеки TypeScript, входящей в комплект поставки.

Интерфейсы

Intl.DateTimeFormat

Документация отсутствует

Intl.DateTimeFormatOptions

Документация отсутствует

Intl.DateTimeFormatRangePart

Представляет часть отформатированного диапазона дат, созданного методом Intl.DateTimeFormat.formatRange().

Intl.Locale

variants

Псевдонимы типов

Intl.Formattable

Типы, которые можно форматировать с помощью методов Intl.DateTimeFormat.

псевдоним типа Intl.Formattable

нестабильный

Типы, которые можно форматировать с помощью методов Intl.DateTimeFormat.

Этот тип определяет, какие значения можно передавать методам Intl.DateTimeFormat для интернационализированного форматирования даты и времени. Он включает стандартные объекты Date и типы даты и времени API Temporal.

Примеры

// Using with Date object
const date = new Date();
const formatter = new Intl.DateTimeFormat('en-US');
console.log(formatter.format(date));

// Using with Temporal types (when available)
const instant = Temporal.Now.instant();
console.log(formatter.format(instant));

Определение


Date
 | Temporal.Instant
 | Temporal.ZonedDateTime
 | Temporal.PlainDate
 | Temporal.PlainTime
 | Temporal.PlainDateTime
 | Temporal.PlainYearMonth
 | Temporal.PlainMonthDay