Intl.NumberFormat.prototype.resolvedOptions()

Метод resolvedOptions() экземпляров Intl.NumberFormat возвращает новый объект со свойствами, отражающими параметры, вычисленные во время инициализации этого объекта NumberFormat.

Попробуйте

const numberFormat = new Intl.NumberFormat("de-DE");
const options = numberFormat.resolvedOptions();

console.log(options.locale);
// Expected output: "de-DE"

console.log(options.numberingSystem);
// Expected output: "latn"

console.log(options.style);
// Expected output: "decimal"

Синтаксис

resolvedOptions()

Параметры

Нет.

Возвращаемое значение

Новый объект со свойствами, отражающими параметры, вычисленные во время инициализации этого объекта NumberFormat. Объект имеет следующие свойства, перечисленные в указанном порядке:

locale

Тег языка BCP 47 для фактически используемого языкового стандарта, определенный в процессе согласования языкового стандарта. В выходные данные может быть включен только ключ расширения Unicode nu, если он запрошен.

numberingSystem

Значение, предоставленное для этого свойства в аргументе options, или с использованием ключа расширения Unicode "nu", с заполнением значения по умолчанию по мере необходимости. Это поддерживаемая система счисления для этого языкового стандарта. Значение по умолчанию зависит от языкового стандарта.

style

Значение, предоставленное для этого свойства в аргументе options, с заполнением значения по умолчанию по мере необходимости. Это либо "decimal", "percent", "currency", либо "unit". Значение по умолчанию — "decimal".

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

Значение, предоставленное для этого свойства в аргументе options. Оно присутствует, только если style равно "currency". Это код валюты ISO 4217; см. Intl.supportedValuesOf(). Оно требуется, если style равно "currency", поэтому значение по умолчанию отсутствует.

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

Значение, предоставленное для этого свойства в аргументе options, с заполнением значения по умолчанию по мере необходимости. Оно присутствует, только если style равно "currency". Это либо "code", "symbol", "narrowSymbol", либо "name". Значение по умолчанию — "symbol".

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

Значение, предоставленное для этого свойства в аргументе options, с заполнением значения по умолчанию по мере необходимости. Оно присутствует, только если style равно "currency". Это либо "standard", либо "accounting". Значение по умолчанию — "standard".

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

Значение, предоставленное для этого свойства в аргументе options. Оно присутствует, только если style равно "unit". Это санкционированный идентификатор единицы измерения из полного списка CLDR. Оно требуется, если style равно "unit", поэтому значение по умолчанию отсутствует.

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

Значение, предоставленное для этого свойства в аргументе options, с заполнением значения по умолчанию по мере необходимости. Оно присутствует, только если style равно "unit". Это либо "short", "narrow", либо "long". Значение по умолчанию — "short".

minimumIntegerDigits

Значение, предоставленное для этого свойства в аргументе options, с заполнением значения по умолчанию по мере необходимости. Это целое число от 1 до 21. Значение по умолчанию — 1.

minimumFractionDigits, maximumFractionDigits Необязательно

Значение, предоставленное для этих свойств в аргументе options, с заполнением значений по умолчанию по мере необходимости. Они присутствуют, только если это необходимо; см. параметры цифр. Это целое число от 0 до 100.

minimumSignificantDigits, maximumSignificantDigits Необязательно

Значение, предоставленное для этих свойств в аргументе options, с заполнением значений по умолчанию по мере необходимости. Они присутствуют, только если это необходимо; см. параметры цифр. Это целое число от 1 до 21.

useGrouping

Значение, предоставленное для этого свойства в аргументе options, с заполнением значения по умолчанию по мере необходимости и с нормализацией некоторых значений. Это либо "always", "auto", "min2", либо логическое значение false. Значение по умолчанию — "min2", если notation равно "compact", и "auto" в противном случае.

notation

Значение, предоставленное для этого свойства в аргументе options, с заполнением значения по умолчанию по мере необходимости. Это либо "standard", "scientific", "engineering", либо "compact". Значение по умолчанию — "standard".

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

Значение, предоставленное для этого свойства в аргументе options, с заполнением значения по умолчанию по мере необходимости. Оно присутствует, только если notation равно "compact". Это либо "short", либо "long". Значение по умолчанию — "short".

signDisplay

Значение, предоставленное для этого свойства в аргументе options, с заполнением значения по умолчанию по мере необходимости. Это либо "auto", "always", "exceptZero", "negative", либо "never". Значение по умолчанию — "auto".

roundingIncrement

Значение, предоставленное для этого свойства в аргументе options, с заполнением значения по умолчанию по мере необходимости. Это одно из значений: 1, 2, 5, 10, 20, 25, 50, 100, 200, 250, 500, 1000, 2000, 2500 и 5000. Значение по умолчанию — 1.

roundingMode

Значение, предоставленное для этого свойства в аргументе options, с заполнением значения по умолчанию по мере необходимости. Это одно из значений: "ceil", "floor", "expand", "trunc", "halfCeil", "halfFloor", "halfExpand", "halfTrunc" и "halfEven". Значение по умолчанию — "halfExpand".

roundingPriority

Значение, предоставленное для этого свойства в аргументе options, с заполнением значения по умолчанию по мере необходимости. Это либо "auto", "morePrecision", либо "lessPrecision". Значение по умолчанию — "auto".

trailingZeroDisplay

Значение, предоставленное для этого свойства в аргументе options, с заполнением значения по умолчанию по мере необходимости. Это либо "auto", либо "stripIfInteger". Значение по умолчанию — "auto".

Примеры

Использование метода resolvedOptions

// Create a NumberFormat
const de = new Intl.NumberFormat("de-DE", {
  style: "currency",
  currency: "USD",
  maximumFractionDigits: 2,
  roundingIncrement: 5,
  roundingMode: "halfCeil",
});

// Resolve the options
const usedOptions = de.resolvedOptions();
console.log(usedOptions.locale); // "de-DE"
console.log(usedOptions.numberingSystem); // "latn"
console.log(usedOptions.compactDisplay); // undefined ("notation" not set to "compact")
console.log(usedOptions.currency); // "USD"
console.log(usedOptions.currencyDisplay); // "symbol"
console.log(usedOptions.currencySign); // "standard"
console.log(usedOptions.minimumIntegerDigits); // 1
console.log(usedOptions.minimumFractionDigits); // 2
console.log(usedOptions.maximumFractionDigits); // 2
console.log(usedOptions.minimumSignificantDigits); // undefined (maximumFractionDigits is set)
console.log(usedOptions.maximumSignificantDigits); // undefined (maximumFractionDigits is set)
console.log(usedOptions.notation); // "standard"
console.log(usedOptions.roundingIncrement); // 5
console.log(usedOptions.roundingMode); // halfCeil
console.log(usedOptions.roundingPriority); // auto
console.log(usedOptions.signDisplay); // "auto"
console.log(usedOptions.style); // "currency"
console.log(usedOptions.trailingZeroDisplay); // auto
console.log(usedOptions.useGrouping); // auto

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

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

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

• Intl.NumberFormat