Temporal.PlainYearMonth.prototype.toJSON()
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 toJSON() của các thực thể Temporal.PlainYearMonth trả về một chuỗi đại diện cho năm-tháng này theo cùng định dạng RFC 9557 như khi gọi toString(). Phương thức này được thiết kế để được gọi ngầm bởi JSON.stringify().
Cú pháp
toJSON()
Tham số
Không có.
Giá trị trả về
Một chuỗi đại diện cho ngày đã cho theo định dạng RFC 9557, bao gồm chú thích lịch nếu lịch không phải là "iso8601".
Mô tả
Phương thức toJSON() được JSON.stringify() tự động gọi khi một đối tượng Temporal.PlainYearMonth được chuyển thành chuỗi. Phương thức này thường được thiết kế để tuần tự hóa các đối tượng Temporal.PlainYearMonth một cách hữu ích theo mặc định trong quá trình tuần tự hóa JSON, và sau đó có thể được giải tuần tự hóa bằng hàm Temporal.PlainYearMonth.from() làm reviver của JSON.parse().
Ví dụ
Sử dụng toJSON()
const ym = Temporal.PlainYearMonth.from({ year: 2021, month: 8 });
const ymStr = ym.toJSON(); // '2021-08'
const ym2 = Temporal.PlainYearMonth.from(ymStr);
Tuần tự hóa và phân tích JSON
Ví dụ này cho thấy cách Temporal.PlainYearMonth có thể được tuần tự hóa thành JSON mà không cần thêm nỗ lực, và cách phân tích ngược lại.
const ym = Temporal.PlainYearMonth.from({ year: 2021, month: 8 });
const ymStr = JSON.stringify({ event: ym }); // '{"event":"2021-08"}'
const obj = JSON.parse(ymStr, (key, value) => {
if (key === "event") {
return Temporal.PlainYearMonth.from(value);
}
return value;
});
Đặc tả
| Thông số kỹ thuật |
|---|
| Temporal # sec-temporal.plainyearmonth.prototype.tojson |