Intl.RelativeTimeFormat.supportedLocalesOf()
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2020.
Phương thức tĩnh Intl.RelativeTimeFormat.supportedLocalesOf() trả về một mảng chứa các locale được cung cấp được hỗ trợ trong định dạng thời gian tương đối mà không phải dùng locale mặc định của runtime.
Try it
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.RelativeTimeFormat.supportedLocalesOf(locales, options));
// Expected output: Array ["id-u-co-pinyin", "de-ID"]
// (Note: the exact output may be browser-dependent)
Cú pháp
Intl.RelativeTimeFormat.supportedLocalesOf(locales)
Intl.RelativeTimeFormat.supportedLocalesOf(locales, options)
Tham số
locales-
Chuỗi với BCP 47 language tag, hoặc một mảng các chuỗi như vậy. Để biết dạng chung và cách diễn giải đối số
locales, xem mô tả tham số trên trang chínhIntl. optionsOptional-
Đối tượng có thể có thuộc tính sau:
localeMatcher-
Thuật toán khớp locale để sử dụng. Các giá trị có thể là
"lookup"và"best fit"; mặc định là"best fit". Để biết thông tin về tùy chọn này, xem trang Intl.
Giá trị trả về
Một mảng chuỗi đại diện cho tập hợp con của các thẻ locale đã cho được hỗ trợ trong định dạng thời gian tương đối mà không phải dùng locale mặc định của runtime.
Ví dụ
>Sử dụng supportedLocalesOf()
Giả sử runtime hỗ trợ tiếng Indonesia và tiếng Đức nhưng không hỗ trợ tiếng Bali trong định dạng thời gian tương đối, supportedLocalesOf trả về các thẻ ngôn ngữ Indonesia và Đức không thay đổi, mặc dù sắp xếp pinyin không liên quan đến định dạng thời gian tương đối và không được dùng với tiếng Indonesia, và tiếng Đức chuyên biệt cho Indonesia khó có thể được hỗ trợ. Lưu ý đặc tả của thuật toán "lookup" ở đây — một bộ khớp "best fit" có thể quyết định rằng tiếng Indonesia là kết hợp phù hợp cho tiếng Bali vì hầu hết người nói tiếng Bali cũng hiểu tiếng Indonesia, và do đó cũng trả về thẻ ngôn ngữ Bali.
const locales = ["ban", "id-u-co-pinyin", "de-ID"];
const options = { localeMatcher: "lookup" };
console.log(Intl.RelativeTimeFormat.supportedLocalesOf(locales, options));
// ["id-u-co-pinyin", "de-ID"]
Đặc tả kỹ thuật
| Specification |
|---|
| ECMAScript® 2026 Internationalization API Specification> # sec-Intl.RelativeTimeFormat.supportedLocalesOf> |