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

js
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ính Intl.

options Optional

Đố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""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.

js
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

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

Xem thêm