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