Intl.Locale.prototype.calendar
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.
Thuộc tính truy cập calendar của các instance Intl.Locale trả về loại lịch cho locale này.
Mô tả
Mặc dù phần lớn thế giới sử dụng lịch Gregory, có nhiều kỷ nguyên lịch theo vùng được dùng trên thế giới. Để biết danh sách các loại lịch được hỗ trợ, xem Intl.supportedValuesOf().
Giá trị của thuộc tính calendar được đặt lúc khởi tạo, thông qua khóa ca của định danh locale hoặc thông qua tùy chọn calendar của hàm khởi tạo Intl.Locale(). Tùy chọn sau có ưu tiên cao hơn nếu cả hai đều có mặt; nếu không có cái nào, thuộc tính có giá trị undefined.
Set accessor của calendar là undefined. Bạn không thể thay đổi thuộc tính này trực tiếp.
Ví dụ
Cũng như các thẻ phụ locale khác, loại lịch có thể được thêm vào đối tượng Intl.Locale thông qua chuỗi locale hoặc đối số đối tượng cấu hình trong hàm khởi tạo.
Thêm loại lịch qua chuỗi locale
Trong đặc tả chuỗi locale Unicode, calendar là một "thẻ phụ mở rộng". Các thẻ phụ này thêm dữ liệu bổ sung về locale và được thêm vào định danh locale bằng khóa mở rộng -u. Để thêm loại lịch vào chuỗi định danh locale ban đầu truyền vào hàm khởi tạo Intl.Locale(), trước tiên hãy thêm khóa mở rộng -u nếu chưa có. Tiếp theo, thêm phần mở rộng -ca để chỉ ra rằng bạn đang thêm loại lịch. Cuối cùng, thêm loại kỷ nguyên lịch.
const locale = new Intl.Locale("fr-FR-u-ca-buddhist");
console.log(locale.calendar); // "buddhist"
Thêm loại lịch qua đối số đối tượng cấu hình
Hàm khởi tạo Intl.Locale() có đối số là đối tượng cấu hình tùy chọn, có thể chứa bất kỳ loại mở rộng nào, bao gồm cả lịch. Đặt thuộc tính calendar của đối tượng cấu hình thành kỷ nguyên lịch mong muốn, rồi truyền vào hàm khởi tạo.
const locale = new Intl.Locale("fr-FR", { calendar: "buddhist" });
console.log(locale.calendar); // "buddhist"
Đặc tả kỹ thuật
| Specification |
|---|
| ECMAScript® 2026 Internationalization API Specification> # sec-Intl.Locale.prototype.calendar> |
Tương thích trình duyệt
Xem thêm
Intl.LocaleIntl.Locale.prototype.getCalendars()- Unicode Calendar Identifier trong đặc tả ngôn ngữ đánh dấu dữ liệu locale Unicode