Intl.Locale.prototype.getCalendars()

Khả dụng hạn chế

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Phương thức getCalendars() của các instance Intl.Locale trả về danh sách một hoặc nhiều định danh lịch duy nhất cho locale này.

Note: Trong một số phiên bản của một số trình duyệt, phương thức này được triển khai dưới dạng thuộc tính truy cập có tên calendars. Tuy nhiên, vì nó trả về một mảng mới mỗi lần truy cập, nó hiện được triển khai dưới dạng phương thức để tránh tình huống locale.calendars === locale.calendars trả về false. Kiểm tra bảng tương thích trình duyệt để biết thêm chi tiết.

Cú pháp

js
getCalendars()

Tham số

Không có.

Giá trị trả về

Một mảng chuỗi đại diện cho tất cả các lịch thường dùng cho Locale, được sắp xếp theo thứ tự ưu tiên giảm dần. Nếu Locale đã có calendar, thì mảng trả về chứa chính xác giá trị đó.

Để biết danh sách các loại lịch được hỗ trợ, xem Intl.supportedValuesOf().

Ví dụ

Lấy danh sách lịch được hỗ trợ

Nếu đối tượng Locale chưa có calendar, getCalendars() liệt kê tất cả các lịch thường dùng cho Locale đã cho. Để xem ví dụ về cách đặt calendar một cách rõ ràng, hãy xem ví dụ về calendar.

js
const arEG = new Intl.Locale("ar-EG");
console.log(arEG.getCalendars()); // ["gregory", "coptic", "islamic", "islamic-civil", "islamic-tbla"]
js
const jaJP = new Intl.Locale("ja-JP");
console.log(jaJP.getCalendars()); // ["gregory", "japanese"]

Đặc tả kỹ thuật

Thông số kỹ thuật
Intl Locale Info Proposal
# sec-Intl.Locale.prototype.getCalendars

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

Xem thêm