Intl.supportedValuesOf()

試一試

console.log(Intl.supportedValuesOf("calendar"));
console.log(Intl.supportedValuesOf("collation"));
console.log(Intl.supportedValuesOf("currency"));
console.log(Intl.supportedValuesOf("numberingSystem"));
console.log(Intl.supportedValuesOf("timeZone"));
console.log(Intl.supportedValuesOf("unit"));
// Expected output: Array ['key'] (for each key)

try {
  Intl.supportedValuesOf("someInvalidKey");
} catch (err) {
  console.log(err.toString());
  // Expected output: RangeError: invalid key: "someInvalidKey"
}

語法

Intl.supportedValuesOf(key)

引數

key

一個鍵字串，指示要返回的值的類別。以下是其中之一：

• "calendar": 參見支援的日曆型別
• "collation": 參見支援的排序規則型別
• "currency": 參見支援的貨幣識別符號
• "numberingSystem": 參見支援的數字系統型別
• "timeZone": 參見支援的時區識別符號
• "unit": 參見支援的單位識別符號

返回值

一個排序後的唯一字串值陣列，表示實現對給定鍵的支援值。可能返回的值如下所示。

支援的日曆型別

以下是瀏覽器通常支援的 calendar 鍵的所有值。這些值可用於 calendar 選項或 Unicode 擴充套件鍵 ca，用於建立 Intl.DateTimeFormat 等物件，以及建立 Temporal 日期物件。

截至 2025 年 10 月，在 japanese 日曆中，1868 年 10 月 23 日 ISO（明治元年 10 月 23 日）之前的日期在瀏覽器中無法按預期工作，主要有兩個方面。首先，CLDR 對明治時代的開始日期有誤，導致日曆實現將明治時代向過去延伸超出實際時間。其次，即將推出的 Intl 紀元和月份程式碼提案規定，明治時代之前的日期應使用公曆紀元，但瀏覽器傳統上使用近似的先前日本紀元。japanese 日曆於明治 6 年 1 月 1 日 / ISO 1873 年 1 月 1 日開始使用，因此這些問題僅影響推算日期。

以下型別在 CLDR 中指定，但在瀏覽器中沒有與上述日曆不同的實現。

參考

• CLDR 日曆型別鍵
• UTS 35, 日期
• 回曆型別 (CLDR 設計提案)

支援的排序規則型別

以下是瀏覽器通常支援的 collation 鍵的所有值。這些值可用於 collation 選項或 Unicode 擴充套件鍵 co，用於建立 Intl.Collator 等物件。

以下型別在 CLDR 資料中指定，但已棄用，不鼓勵顯式使用，並且/或者瀏覽器可能由於各種原因不支援它們。請避免使用它們

參考

• CLDR 排序型別鍵
• UTS 35, 排序

支援的貨幣識別符號

貨幣識別符號是 ISO 4217 中定義的三字母大寫程式碼。這些值可用於建立 Intl.NumberFormat 等物件時的 currency 選項，以及 Intl.DisplayNames.prototype.of()。常用識別符號有 300 多個，因此我們不會在此列出。有關所有可能識別符號的詳盡列表，請參閱 維基百科文章。

參考

• CLDR 貨幣型別鍵
• ISO 4217 貨幣程式碼
• UTS 35, 貨幣

支援的數字系統型別

以下是瀏覽器通常支援的 numberingSystem 鍵的所有值。這些值可用於建立 Intl.NumberFormat 等物件時的 numberingSystem 選項或 Unicode 擴充套件鍵 nu。對於帶有“數字字元”的行，執行時會逐個翻譯數字而無需額外操作。其他標記為“演算法”的則需要額外的演算法來翻譯數字。Unicode 碼點越高，數字系統越新，所有瀏覽器支援的可能性就越低。

有三個特殊值：native、traditio 和 finance，它們的含義取決於區域設定，並將根據區域設定解析為正確的系統。因此，resolvedOptions() 方法永遠不會返回這些值，但 Intl.Locale.prototype.numberingSystem 會返回（如果作為輸入提供）。

參考

• CLDR 數字系統型別鍵
• CLDR 數字系統定義
• UTS 35, 數字系統

支援的時區識別符號

支援的時區識別符號可用於建立 Intl.DateTimeFormat 等物件時的 timeZone 選項，以及建立 Temporal 日期物件。常用識別符號有 400 多個，因此我們不會在此列出。有關所有可能識別符號的詳盡列表，請參閱 維基百科文章 或 IANA 時區資料庫。

瀏覽列表時，請注意 Temporal 的標準化要求瀏覽器始終返回 IANA 資料庫中的主要識別符號，該識別符號可能會隨時間變化。有關更多資訊，請參閱時區和偏移量。例如，返回的陣列應包含 "Asia/Kolkata" 而不是 "Asia/Calcutta"，因為後者是前者的別名，並且它們都對應印度；但是，它應該包含 "Africa/Abidjan" 和 "Atlantic/Reykjavik"，因為它們在不同的國家，儘管後者也是前者的別名。

參考

• IANA 時區資料庫
• UTS 35, 時區識別符號

支援的單位識別符號

以下是瀏覽器通常支援的 unit 鍵的所有值。這些值可用於建立 Intl.NumberFormat 等物件時的 unit 選項。此列表是 ECMA-402 規範明確批准的 CLDR 子集，因此所有實現都應保持一致。

• acre
• bit
• byte
• celsius
• centimeter
• 日
• degree
• fahrenheit
• fluid-ounce
• foot
• gallon
• gigabit
• gigabyte
• gram
• hectare
• 小時
• inch
• kilobit
• kilobyte
• kilogram
• kilometer
• liter
• megabit
• megabyte
• meter
• microsecond
• mile
• mile-scandinavian
• milliliter
• millimeter
• millisecond
• minute
• 月份
• nanosecond
• ounce
• percent
• petabyte
• pound
• 秒
• stone
• terabit
• terabyte
• 周
• yard
• 年

指定單位時，你還可以使用“-per-”分隔符組合兩個單位。例如，meter-per-second 或 liter-per-megabyte。

參考

• ECMA-402 批准的單一單位
• CLDR 單位有效性資料
• UTS 35, 單位識別符號

異常

RangeError

如果傳遞了不支援的鍵作為引數，則丟擲。

示例

功能測試

你可以透過與 undefined 比較來檢查該方法是否受支援

if (typeof Intl.supportedValuesOf !== "undefined") {
  // method is supported
}

獲取鍵的所有值

要獲取日曆支援的值，你可以使用鍵 "calendar" 呼叫該方法。然後，你可以遍歷返回的陣列，如下所示：

Intl.supportedValuesOf("calendar").forEach((calendar) => {
  // "buddhist", "chinese", "coptic", "dangi", etc.
});

其他所有值都以相同的方式獲取。

Intl.supportedValuesOf("collation").forEach((collation) => {
  // "compat", "dict", "emoji", etc.
});

Intl.supportedValuesOf("currency").forEach((currency) => {
  // "ADP", "AED", "AFA", "AFN", "ALK", "ALL", "AMD", etc.
});

Intl.supportedValuesOf("numberingSystem").forEach((numberingSystem) => {
  // "adlm", "ahom", "arab", "arabext", "bali", etc.
});

Intl.supportedValuesOf("timeZone").forEach((timeZone) => {
  // "Africa/Abidjan", "Africa/Accra", "Africa/Addis_Ababa", "Africa/Algiers", etc.
});

Intl.supportedValuesOf("unit").forEach((unit) => {
  // "acre", "bit", "byte", "celsius", "centimeter", etc.
});

無效鍵丟擲 RangeError

try {
  Intl.supportedValuesOf("someInvalidKey");
} catch (err) {
  // RangeError: invalid key: "someInvalidKey"
}

規範

瀏覽器相容性

另見

• FormatJS 中 Intl.supportedValuesOf 的 Polyfill
• Intl