Temporal.PlainYearMonth.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 Instanzen des Typs Temporal.PlainYearMonth gibt eine Zeichenkette zurück, die diesen Jahr-Monat im gleichen RFC 9557 Format darstellt wie ein Aufruf von toString(). Sie soll implizit von JSON.stringify() aufgerufen werden.
Syntax
toJSON()
Parameter
Keine.
Rückgabewert
Eine Zeichenkette, die das angegebene Datum im RFC 9557 Format darstellt, mit der Kalenderanmerkung, falls diese nicht "iso8601" ist.
Beschreibung
Die toJSON()-Methode wird von JSON.stringify() automatisch aufgerufen, wenn ein Temporal.PlainYearMonth-Objekt in eine Zeichenkette umgewandelt wird. Diese Methode soll im Allgemeinen standardmäßig verwendet werden, um Temporal.PlainYearMonth-Objekte während der JSON-Serialisierung sinnvoll zu serialisieren. Diese können dann mithilfe der Funktion Temporal.PlainYearMonth.from() als Reviver bei JSON.parse() deserialisiert werden.
Beispiele
Verwendung von toJSON()
const ym = Temporal.PlainYearMonth.from({ year: 2021, month: 8 });
const ymStr = ym.toJSON(); // '2021-08'
const ym2 = Temporal.PlainYearMonth.from(ymStr);
JSON-Serialisierung und -Parsing
Dieses Beispiel zeigt, wie Temporal.PlainYearMonth ohne großen Aufwand als JSON serialisiert und wieder geparst werden kann.
const ym = Temporal.PlainYearMonth.from({ year: 2021, month: 8 });
const ymStr = JSON.stringify({ event: ym }); // '{"event":"2021-08"}'
const obj = JSON.parse(ymStr, (key, value) => {
if (key === "event") {
return Temporal.PlainYearMonth.from(value);
}
return value;
});
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plainyearmonth.prototype.tojson |