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 calendarundefined. 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.

js
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.

js
const locale = new Intl.Locale("fr-FR", { calendar: "buddhist" });
console.log(locale.calendar); // "buddhist"

Đặc tả kỹ thuật

Thông số kỹ thuật
ECMAScript® 2026 Internationalization API Specification
# sec-Intl.Locale.prototype.calendar

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

Xem thêm