Temporal.PlainDateTime.prototype.toJSON()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die toJSON() Methode von Temporal.PlainDateTime Instanzen gibt einen String zurück, der dieses Datum-Uhrzeit im gleichen RFC 9557 Format darstellt, wie beim Aufruf von toString(). Sie ist dazu bestimmt, implizit von JSON.stringify() aufgerufen zu werden.
Syntax
toJSON()
Parameter
Keine.
Rückgabewert
Ein String, der das angegebene Datum-Uhrzeit im RFC 9557 Format darstellt, einschließlich der Kalenderanmerkung, wenn diese nicht "iso8601" ist.
Beschreibung
Die toJSON() Methode wird automatisch von JSON.stringify() aufgerufen, wenn ein Temporal.PlainDateTime Objekt in einen String umgewandelt wird. Diese Methode ist im Allgemeinen dazu gedacht, Temporal.PlainDateTime Objekte während der JSON Serialisierung sinnvoll zu serialisieren, sodass sie dann mit der Temporal.PlainDateTime.from() Funktion als Rückgewinnung von JSON.parse() deserialisiert werden können.
Beispiele
Verwendung von toJSON()
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-Serialisierung und -Parsing
Dieses Beispiel zeigt, wie Temporal.PlainDateTime ohne zusätzlichen Aufwand als JSON serialisiert und wie es wieder geparst werden kann.
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;
});
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plaindatetime.prototype.tojson |