Temporal.PlainDate.prototype.toString()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Phương thức toString() của các instance Temporal.PlainDate trả về một chuỗi đại diện cho ngày này theo định dạng RFC 9557.
Cú pháp
toString()
toString(options)
Tham số
optionsOptional-
Một đối tượng chứa thuộc tính sau:
calendarNameOptional-
Có nên hiển thị chú thích lịch (
[u-ca=calendar_id]) trong giá trị trả về hay không. Các giá trị có thể là:"auto"(mặc định)-
Bao gồm chú thích lịch nếu lịch không phải là
"iso8601". "always"-
Luôn bao gồm chú thích lịch.
"never"-
Không bao giờ bao gồm chú thích lịch. Điều này làm cho chuỗi trả về không thể phục hồi lại thành cùng một instance
Temporal.PlainDate, mặc dù giá trị ngày vẫn giữ nguyên. "critical"-
Luôn bao gồm chú thích lịch và thêm cờ quan trọng:
[!u-ca=calendar_id]. Hữu ích khi gửi chuỗi đến một số hệ thống nhất định, nhưng không hữu ích cho bản thân Temporal.
Giá trị trả về
Một chuỗi theo định dạng RFC 9557 đại diện cho ngày này. Chú thích lịch được bao gồm như đã chỉ định.
Ngoại lệ
RangeError-
Ném ra nếu bất kỳ tùy chọn nào không hợp lệ.
TypeError-
Ném ra nếu
optionskhông phải là đối tượng hoặcundefined.
Ví dụ
Sử dụng toString()
const date = Temporal.PlainDate.from("2021-08-01");
console.log(date.toString()); // '2021-08-01'
Sử dụng tùy chọn
const isoDate = Temporal.PlainDate.from({ year: 2021, month: 8, day: 1 });
const date = Temporal.PlainDate.from({
year: 2021,
month: 8,
day: 1,
calendar: "islamic-umalqura",
});
console.log(isoDate.toString({ calendarName: "auto" })); // '2021-08-01'
console.log(date.toString({ calendarName: "auto" })); // '2582-12-17[u-ca=islamic-umalqura]'
console.log(isoDate.toString({ calendarName: "always" })); // '2021-08-01[u-ca=iso8601]'
console.log(date.toString({ calendarName: "always" })); // '2582-12-17[u-ca=islamic-umalqura]'
console.log(date.toString({ calendarName: "never" })); // '2582-12-17'
console.log(isoDate.toString({ calendarName: "critical" })); // '2021-08-01[!u-ca=iso8601]'
console.log(date.toString({ calendarName: "critical" })); // '2582-12-17[!u-ca=islamic-umalqura]'
Đặc tả
| Specification |
|---|
| Temporal # sec-temporal.plaindate.prototype.tostring |