Temporal.PlainDateTime.prototype.toJSON()
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more browser support for this feature? Tell us why.
Die Methode toJSON() von Temporal.PlainDateTime-Instanzen gibt eine Zeichenfolge zurück, die dieses Datum und diese Uhrzeit im selben RFC-9557-Format darstellt wie ein Aufruf von toString(). Sie ist dafür vorgesehen, implizit von JSON.stringify() aufgerufen zu werden.
Syntax
toJSON()
Parameter
Keine.
Rückgabewert
Eine Zeichenfolge, die das angegebene Datum und die angegebene Uhrzeit im RFC-9557-Format darstellt. Die Kalenderannotation ist enthalten, wenn der Kalender nicht "iso8601" ist.
Beschreibung
Die Methode wird automatisch von JSON.stringify() aufgerufen, wenn bei der JSON-Serialisierung ein Temporal.PlainDateTime-Objekt auftritt. Der serialisierte Wert kann anschließend mit der Funktion Temporal.PlainDateTime.from() innerhalb der Reviver-Funktion von JSON.parse() deserialisiert werden.
Beispiele
toJSON() verwenden
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 anschließend 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 |