Intl.supportedValuesOf()

Try it

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"
}

Cú pháp

Intl.supportedValuesOf(key)

Tham số

key

Một chuỗi khóa chỉ ra danh mục giá trị cần trả về. Đây là một trong các giá trị:

• "calendar": xem các loại calendar được hỗ trợ
• "collation": xem các loại collation được hỗ trợ
• "currency": xem các identifier currency được hỗ trợ
• "numberingSystem": xem các loại numbering system được hỗ trợ
• "timeZone": xem các identifier time zone được hỗ trợ
• "unit": xem các identifier unit được hỗ trợ

Giá trị trả về

Một mảng được sắp xếp gồm các chuỗi duy nhất chỉ ra các giá trị được hỗ trợ bởi implementation cho key đã cho. Các giá trị có thể được trả về được liệt kê dưới đây.

Các loại calendar được hỗ trợ

Dưới đây là tất cả các giá trị thường được trình duyệt hỗ trợ cho khóa calendar. Các giá trị này có thể được dùng cho tùy chọn calendar hoặc Unicode extension key ca khi tạo các đối tượng như Intl.DateTimeFormat, cũng như khi tạo các đối tượng date Temporal. Danh sách này được ECMA-402 specification chỉ định tường minh, vì vậy tất cả các implementation phải nhất quán.

Tính đến tháng 10 năm 2025, trong lịch japanese, các ngày trước 1868-10-23 ISO (ngày bắt đầu của năm Meiji 1) không hoạt động đúng như mong đợi trong trình duyệt theo hai cách. Thứ nhất, CLDR có ngày bắt đầu sai cho kỷ nguyên Meiji, khiến các implementation lịch mở rộng kỷ nguyên Meiji xa hơn trong quá khứ so với thực tế. Thứ hai, đề xuất Intl era và monthCode sắp tới quy định rằng các ngày trước 1873-01-01 ISO nên dùng kỷ nguyên Gregorian, nhưng trình duyệt theo truyền thống đã dùng các xấp xỉ của các kỷ nguyên Nhật Bản trước đó. Lịch japanese được đưa vào sử dụng vào ngày 1 tháng 1, Meiji 6 / 1873-01-01 ISO, vì vậy các vấn đề này chỉ ảnh hưởng đến các ngày proleptic.

Các loại dưới đây được quy định trong CLDR nhưng không có implementation khác biệt so với các lịch trên trong trình duyệt.

Các tài liệu Temporal.PlainDate.prototype.era và Temporal.PlainDate.prototype.monthCode cung cấp thêm thông tin về các lịch khác nhau.

Tài liệu tham khảo:

• CLDR Calendar type keys
• UTS 35, Dates
• Islamic calendar types (CLDR design proposal)

Các loại collation được hỗ trợ

Dưới đây là tất cả các giá trị thường được trình duyệt hỗ trợ cho khóa collation. Các giá trị này có thể được dùng cho tùy chọn collation hoặc Unicode extension key co khi tạo các đối tượng như Intl.Collator.

Các loại dưới đây được quy định trong dữ liệu CLDR, nhưng đã deprecated, không nên dùng tường minh, và/hoặc có thể không được trình duyệt chỉ ra là được hỗ trợ vì nhiều lý do. Tránh sử dụng chúng:

Tài liệu tham khảo:

• CLDR Collation type keys
• UTS 35, Collation

Các identifier currency được hỗ trợ

Các identifier currency là các mã ba chữ in hoa được định nghĩa trong ISO 4217. Các giá trị này có thể được dùng cho tùy chọn currency khi tạo các đối tượng như Intl.NumberFormat, cũng như cho Intl.DisplayNames.prototype.of(). Có hơn 300 identifier thường dùng nên chúng tôi sẽ không liệt kê chúng. Để biết danh sách đầy đủ các identifier có thể có, xem bài viết Wikipedia.

Tài liệu tham khảo:

• CLDR Currency type keys
• ISO 4217 Currency codes
• UTS 35, Currencies

Các loại numbering system được hỗ trợ

Dưới đây là tất cả các giá trị thường được trình duyệt hỗ trợ cho khóa numberingSystem. Các giá trị này có thể được dùng cho tùy chọn numberingSystem hoặc Unicode extension key nu khi tạo các đối tượng như Intl.NumberFormat. Đối với các hàng có "ký tự chữ số", runtime dịch các chữ số từng cái một mà không cần thao tác thêm. Các loại khác được đánh dấu là "algorithmic" cần các thuật toán bổ sung để dịch chữ số. Code point Unicode càng cao, numbering system càng mới và càng có khả năng không được tất cả trình duyệt hỗ trợ.

Có ba giá trị đặc biệt: native, traditio, và finance, có nghĩa phụ thuộc vào locale và sẽ được giải quyết thành hệ thống phù hợp tùy theo locale. Do đó, các phương thức resolvedOptions() sẽ không bao giờ trả về các giá trị này, nhưng Intl.Locale.prototype.numberingSystem sẽ trả về (nếu được cung cấp làm đầu vào).

Tài liệu tham khảo:

• CLDR Numbering system type keys
• CLDR Numbering system definitions
• UTS 35, Numbering systems

Các identifier time zone được hỗ trợ

Các identifier time zone được hỗ trợ có thể được dùng cho tùy chọn timeZone khi tạo các đối tượng như Intl.DateTimeFormat, cũng như khi tạo các đối tượng date Temporal. Có hơn 400 identifier thường dùng nên chúng tôi sẽ không liệt kê chúng. Để biết danh sách đầy đủ các identifier có thể có, xem bài viết Wikipedia hoặc cơ sở dữ liệu múi giờ IANA.

Khi duyệt danh sách, lưu ý rằng việc chuẩn hóa Temporal yêu cầu trình duyệt luôn trả về identifier chính trong cơ sở dữ liệu IANA, có thể thay đổi theo thời gian. Xem time zones and offsets để biết thêm thông tin. Ví dụ, mảng được trả về nên chứa "Asia/Kolkata" thay vì "Asia/Calcutta" vì cái sau là alias của cái trước và cả hai đều tương ứng với Ấn Độ; tuy nhiên, nó nên chứa cả "Africa/Abidjan" và "Atlantic/Reykjavik" vì chúng ở các quốc gia khác nhau, mặc dù cái sau cũng là alias của cái trước.

Tài liệu tham khảo:

• IANA Time Zone Database
• UTS 35, Time Zone Identifiers

Các identifier unit được hỗ trợ

Dưới đây là tất cả các giá trị thường được trình duyệt hỗ trợ cho khóa unit. Các giá trị này có thể được dùng cho tùy chọn unit khi tạo các đối tượng như Intl.NumberFormat. Danh sách này là tập con của CLDR được ECMA-402 specification chỉ định tường minh, vì vậy tất cả các implementation phải nhất quán.

• acre
• bit
• byte
• celsius
• centimeter
• day
• degree
• fahrenheit
• fluid-ounce
• foot
• gallon
• gigabit
• gigabyte
• gram
• hectare
• hour
• inch
• kilobit
• kilobyte
• kilogram
• kilometer
• liter
• megabit
• megabyte
• meter
• microsecond
• mile
• mile-scandinavian
• milliliter
• millimeter
• millisecond
• minute
• month
• nanosecond
• ounce
• percent
• petabyte
• pound
• second
• stone
• terabit
• terabyte
• week
• yard
• year

Khi chỉ định các đơn vị, bạn cũng có thể kết hợp hai đơn vị với dấu phân cách "-per-". Ví dụ, meter-per-second hoặc liter-per-megabyte.

Tài liệu tham khảo:

• ECMA-402 sanctioned single units
• CLDR Unit validity data
• UTS 35, Unit identifiers

Ngoại lệ

RangeError

Ném ra nếu một khóa không được hỗ trợ được truyền làm tham số.

Ví dụ

Kiểm tra tính năng

Bạn có thể kiểm tra phương thức được hỗ trợ hay không bằng cách so sánh với undefined:

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

Lấy tất cả giá trị cho một khóa

Để lấy các giá trị được hỗ trợ cho calendar, bạn gọi phương thức với khóa "calendar". Sau đó bạn có thể lặp qua mảng được trả về như dưới đây:

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

Các giá trị khác đều thu được theo cách tương tự:

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.
});

Khóa không hợp lệ ném ra RangeError

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

Đặc tả kỹ thuật

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

Xem thêm

• Polyfill của Intl.supportedValuesOf trong FormatJS
• Intl