Temporal.PlainDate.prototype.withCalendar()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Phương thức withCalendar() của các instance Temporal.PlainDate trả về một đối tượng Temporal.PlainDate mới đại diện cho ngày này được diễn giải trong hệ thống lịch mới. Vì tất cả các đối tượng Temporal được thiết kế để bất biến (immutable), phương thức này về cơ bản hoạt động như setter cho thuộc tính calendarId của ngày.
Để thay thế các thuộc tính thành phần ngày, hãy sử dụng phương thức with() thay thế.
Cú pháp
withCalendar(calendar)
Tham số
calendar-
Một chuỗi tương ứng với thuộc tính
calendarId. XemIntl.supportedValuesOf()để biết danh sách các loại lịch được hỗ trợ phổ biến.
Giá trị trả về
Một đối tượng Temporal.PlainDate mới, đại diện cho ngày được chỉ định bởi PlainDate gốc, được diễn giải trong hệ thống lịch mới.
Ngoại lệ
TypeError-
Được ném ra nếu
calendarkhông phải là một chuỗi. RangeError-
Được ném ra nếu
calendarkhông phải là một định danh lịch hợp lệ.
Ví dụ
Sử dụng withCalendar()
const date = Temporal.PlainDate.from("2021-07-01");
const newDate = date.withCalendar("islamic-umalqura");
console.log(newDate.toLocaleString("en-US", { calendar: "islamic-umalqura" }));
// 11/21/1442 AH
Đặc tả
| Specification |
|---|
| Temporal # sec-temporal.plaindate.prototype.withcalendar |