Temporal.PlainDateTime.prototype.toJSON()
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
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
| Spezifikation |
|---|
| Temporal # sec-temporal.plaindatetime.prototype.tojson |