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