Intl.NumberFormat.prototype.resolvedOptions()
Intl.NumberFormat 例項的 resolvedOptions() 方法返回一個新物件，其中包含此 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 語言標籤。輸出中可能只包含請求的
nuUnicode 擴充套件鍵（如果已請求）。 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。如果notation為"compact"，則預設值為"min2"，否則為"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
規範
| 規範 |
|---|
| ECMAScript® 2026 國際化 API 規範 # sec-intl.numberformat.prototype.resolvedoptions |
瀏覽器相容性
載入中…