Temporal.PlainDate.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.PlainDate-Instanzen gibt einen String zurück, der dieses Datum im selben RFC 9557-Format darstellt wie ein Aufruf von toString(). Diese Methode wird implizit von JSON.stringify() aufgerufen.
Syntax
toJSON()
Parameter
Keine.
Rückgabewert
Ein String, der das gegebene Datum im RFC 9557-Format darstellt, wobei die Kalenderannotation enthalten ist, falls sie nicht "iso8601" ist.
Beschreibung
Die toJSON()-Methode wird automatisch von JSON.stringify() aufgerufen, wenn ein Temporal.PlainDate-Objekt in einen String konvertiert wird. Diese Methode dient im Allgemeinen dem Zweck, Temporal.PlainDate-Objekte während der JSON-Serialisierung nützlich zu serialisieren, die dann mit der Temporal.PlainDate.from()-Funktion als Rückruf von JSON.parse() deserialisiert werden können.
Beispiele
Verwendung von 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);
JSON-Serialisierung und -Parsing
Dieses Beispiel zeigt, wie Temporal.PlainDate ohne zusätzlichen Aufwand als JSON serialisiert und wie es wieder geparst werden kann.
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;
});
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plaindate.prototype.tojson |