Temporal.PlainYearMonth.prototype.toJSON()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die toJSON()-Methode von Instanzen des Temporal.PlainYearMonth gibt eine Zeichenkette zurück, die diesen Jahr-Monat im selben RFC 9557-Format darstellt, wie bei einem 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, wobei die Kalenderanmerkung enthalten ist, wenn sie nicht "iso8601" ist.
Beschreibung
Die Methode toJSON() wird automatisch von JSON.stringify() aufgerufen, wenn ein Temporal.PlainYearMonth-Objekt in eine Zeichenkette umgewandelt wird. Diese Methode ist allgemein dazu gedacht, standardmäßig Temporal.PlainYearMonth-Objekte während der JSON-Serialisierung sinnvoll zu serialisieren, was dann mittels der Funktion Temporal.PlainYearMonth.from() als Reviver von JSON.parse() deserialisiert werden kann.
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 zusätzlichen 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 |
Browser-Kompatibilität
Loading…