Temporal.PlainYearMonth.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.PlainYearMonth-Instanzen gibt einen String zurück, der dieses Jahr und diesen Monat 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
Ein String, der das angegebene Datum im RFC-9557-Format darstellt. Die Kalenderannotation ist enthalten, wenn der Kalender nicht "iso8601" ist.
Beschreibung
Die Methode toJSON() wird automatisch von JSON.stringify() aufgerufen, wenn ein Temporal.PlainYearMonth-Objekt in einen String umgewandelt wird. Sie dient im Allgemeinen dazu, Temporal.PlainYearMonth-Objekte bei der JSON-Serialisierung standardmäßig in einer brauchbaren Form zu serialisieren. Anschließend können sie mithilfe der Funktion Temporal.PlainYearMonth.from() im Reviver von JSON.parse() deserialisiert werden.
Beispiele
toJSON() verwenden
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 anschließend wieder eingelesen 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
| Spezifikation |
|---|
| Temporal # sec-temporal.plainyearmonth.prototype.tojson |