Intl.NumberFormat.prototype.resolvedOptions()

Try it

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"

Cú pháp

resolvedOptions()

Tham số

Không có.

Giá trị trả về

Một đối tượng mới với các thuộc tính phản ánh các tùy chọn được tính toán trong quá trình khởi tạo đối tượng NumberFormat này. Đối tượng có các thuộc tính sau, theo thứ tự được liệt kê:

locale

BCP 47 language tag cho locale thực sự được dùng, được xác định bởi quá trình thương lượng locale. Chỉ khóa mở rộng Unicode nu, nếu được yêu cầu, mới có thể được bao gồm trong đầu ra.

numberingSystem

Giá trị được cung cấp cho thuộc tính này trong đối số options, hoặc sử dụng khóa mở rộng Unicode "nu", với giá trị mặc định được điền vào khi cần. Đây là hệ thống đánh số được hỗ trợ cho locale này. Mặc định phụ thuộc vào locale.

style

Giá trị được cung cấp cho thuộc tính này trong đối số options, với giá trị mặc định được điền vào khi cần. Là "decimal", "percent", "currency" hoặc "unit". Mặc định là "decimal".

currency Optional

Giá trị được cung cấp cho thuộc tính này trong đối số options. Chỉ có mặt nếu style là "currency". Là mã tiền tệ ISO 4217; xem Intl.supportedValuesOf(). Bắt buộc nếu style là "currency" nên không có giá trị mặc định.

currencyDisplay Optional

Giá trị được cung cấp cho thuộc tính này trong đối số options, với giá trị mặc định được điền vào khi cần. Chỉ có mặt nếu style là "currency". Là "code", "symbol", "narrowSymbol" hoặc "name". Mặc định là "symbol".

currencySign Optional

Giá trị được cung cấp cho thuộc tính này trong đối số options, với giá trị mặc định được điền vào khi cần. Chỉ có mặt nếu style là "currency". Là "standard" hoặc "accounting". Mặc định là "standard".

unit Optional

Giá trị được cung cấp cho thuộc tính này trong đối số options. Chỉ có mặt nếu style là "unit". Là định danh đơn vị được chấp thuận từ danh sách CLDR đầy đủ. Bắt buộc nếu style là "unit" nên không có giá trị mặc định.

unitDisplay Optional

Giá trị được cung cấp cho thuộc tính này trong đối số options, với giá trị mặc định được điền vào khi cần. Chỉ có mặt nếu style là "unit". Là "short", "narrow" hoặc "long". Mặc định là "short".

minimumIntegerDigits

Giá trị được cung cấp cho thuộc tính này trong đối số options, với giá trị mặc định được điền vào khi cần. Là số nguyên từ 1 đến 21. Mặc định là 1.

minimumFractionDigits, maximumFractionDigits Optional

Giá trị được cung cấp cho các thuộc tính này trong đối số options, với giá trị mặc định được điền vào khi cần. Chỉ có mặt khi cần thiết; xem tùy chọn chữ số. Là số nguyên từ 0 đến 100.

minimumSignificantDigits, maximumSignificantDigits Optional

Giá trị được cung cấp cho các thuộc tính này trong đối số options, với giá trị mặc định được điền vào khi cần. Chỉ có mặt khi cần thiết; xem tùy chọn chữ số. Là số nguyên từ 1 đến 21.

useGrouping

Giá trị được cung cấp cho thuộc tính này trong đối số options, với giá trị mặc định được điền vào khi cần, và một số giá trị được chuẩn hóa. Là "always", "auto", "min2" hoặc boolean false. Mặc định là "min2" nếu notation là "compact", và "auto" trong các trường hợp khác.

notation

Giá trị được cung cấp cho thuộc tính này trong đối số options, với giá trị mặc định được điền vào khi cần. Là "standard", "scientific", "engineering" hoặc "compact". Mặc định là "standard".

compactDisplay Optional

Giá trị được cung cấp cho thuộc tính này trong đối số options, với giá trị mặc định được điền vào khi cần. Chỉ có mặt nếu notation là "compact". Là "short" hoặc "long". Mặc định là "short".

signDisplay

Giá trị được cung cấp cho thuộc tính này trong đối số options, với giá trị mặc định được điền vào khi cần. Là "auto", "always", "exceptZero", "negative" hoặc "never". Mặc định là "auto".

roundingIncrement

Giá trị được cung cấp cho thuộc tính này trong đối số options, với giá trị mặc định được điền vào khi cần. Là một trong 1, 2, 5, 10, 20, 25, 50, 100, 200, 250, 500, 1000, 2000, 2500 và 5000. Mặc định là 1.

roundingMode

Giá trị được cung cấp cho thuộc tính này trong đối số options, với giá trị mặc định được điền vào khi cần. Là một trong "ceil", "floor", "expand", "trunc", "halfCeil", "halfFloor", "halfExpand", "halfTrunc" và "halfEven". Mặc định là "halfExpand".

roundingPriority

Giá trị được cung cấp cho thuộc tính này trong đối số options, với giá trị mặc định được điền vào khi cần. Là "auto", "morePrecision" hoặc "lessPrecision". Mặc định là "auto".

trailingZeroDisplay

Giá trị được cung cấp cho thuộc tính này trong đối số options, với giá trị mặc định được điền vào khi cần. Là "auto" hoặc "stripIfInteger". Mặc định là "auto".

Ví dụ

Sử dụng phương thức 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

Đặc tả kỹ thuật

Tương thích trình duyệt

Xem thêm

• Intl.NumberFormat