Temporal.ZonedDateTime.prototype.withCalendar()
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 withCalendar() của các thực thể Temporal.ZonedDateTime trả về một đối tượng Temporal.ZonedDateTime mới biểu thị 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ế để bất biến, 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 sử dụng phương thức with(). Để thay thế múi giờ của nó, hãy sử dụng phương thức withTimeZone().
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.ZonedDateTime mới, biểu thị ngày-giờ được chỉ định bởi ZonedDateTime ban đầu, đượ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 zdt = Temporal.ZonedDateTime.from(
"2021-07-01T12:34:56[America/New_York]",
);
const newZDT = zdt.withCalendar("islamic-umalqura");
console.log(newZDT.toLocaleString("en-US", { calendar: "islamic-umalqura" }));
// 11/21/1442 AH, 12:34:56 PM EDT
Đặc tả
| Thông số kỹ thuật |
|---|
| Temporal # sec-temporal.zoneddatetime.prototype.withcalendar |