Temporal.PlainDateTime.prototype.toJSON()

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

The **toJSON()** method of {{jsxref("Temporal.PlainDateTime")}} instances returns a string representing this date-time in the same RFC 9557 format as calling {{jsxref("Temporal/PlainDateTime/toString", "toString()")}}. It is intended to be implicitly called by {{jsxref("JSON.stringify()")}}.

Syntax

js-nolint
toJSON()

Parameters

None.

Return value

A string representing the given date-time in the RFC 9557 format, with the calendar annotation included if it is not "iso8601".

Description

The method is automatically called by {{jsxref("JSON.stringify()")}} when a Temporal.PlainDateTime object is encountered during JSON serialization. The serialized value can then be deserialized using the {{jsxref("Temporal/PlainDateTime/from", "Temporal.PlainDateTime.from()")}} function within the reviver of {{jsxref("JSON.parse()")}}.

Examples

Using toJSON()

js
const dt = Temporal.PlainDateTime.from({ year: 2021, month: 8, day: 1 });
const dtStr = dt.toJSON(); // '2021-08-01T00:00:00'
const dt2 = Temporal.PlainDateTime.from(dtStr);

JSON serialization and parsing

This example shows how Temporal.PlainDateTime can be serialized as JSON without extra effort, and how to parse it back.

js
const dt = Temporal.PlainDateTime.from({ year: 2021, month: 8, day: 1 });
const jsonStr = JSON.stringify({ nextBilling: dt }); // '{"nextBilling":"2021-08-01T00:00:00"}'
const obj = JSON.parse(jsonStr, (key, value) => {
  if (key === "nextBilling") {
    return Temporal.PlainDateTime.from(value);
  }
  return value;
});

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • {{jsxref("Temporal.PlainDateTime")}}
  • {{jsxref("Temporal/PlainDateTime/from", "Temporal.PlainDateTime.from()")}}
  • {{jsxref("Temporal/PlainDateTime/toString", "Temporal.PlainDateTime.prototype.toString()")}}
  • {{jsxref("Temporal/PlainDateTime/toLocaleString", "Temporal.PlainDateTime.prototype.toLocaleString()")}}