Temporal.PlainDateTime.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.PlainDateTime trả về một đối tượng Temporal.PlainDateTime mới đại diện cho ngày-giờ 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ế là 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-giờ.
Để thay thế các thuộc tính thành phần ngày-giờ, hãy 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 thường được hỗ trợ.
Giá trị trả về
Một đối tượng Temporal.PlainDateTime mới, đại diện cho ngày-giờ được chỉ định bởi PlainDateTime 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à chuỗi. RangeError-
Được ném ra nếu
calendarkhông phải là định danh lịch hợp lệ.
Ví dụ
Sử dụng withCalendar()
const dt = Temporal.PlainDateTime.from("2021-07-01T12:34:56");
const newDT = dt.withCalendar("islamic-umalqura");
console.log(newDT.toLocaleString("en-US", { calendar: "islamic-umalqura" }));
// 11/21/1442 AH, 12:34:56 PM
Đặc tả
| Specification |
|---|
| Temporal # sec-temporal.plaindatetime.prototype.withcalendar |