Temporal.PlainMonthDay.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.PlainMonthDay-Instanzen gibt einen String zurück, der diesen Monat und Tag 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 den angegebenen Monat und Tag im RFC-9557-Format darstellt. Das Jahr und die Kalenderannotation werden einbezogen, wenn der Kalender nicht "iso8601" ist.
Beschreibung
Die Methode toJSON() wird automatisch von JSON.stringify() aufgerufen, wenn ein Temporal.PlainMonthDay-Objekt in einen String umgewandelt wird. Sie ist dafür vorgesehen, Temporal.PlainMonthDay-Objekte bei der JSON-Serialisierung standardmäßig in einer geeigneten Form zu serialisieren. Anschließend können sie mit der Funktion Temporal.PlainMonthDay.from() innerhalb der Reviver-Funktion von JSON.parse() deserialisiert werden.
Beispiele
Verwendung von toJSON()
const md = Temporal.PlainMonthDay.from({ month: 8, day: 1 });
const mdStr = md.toJSON(); // '08-01'
const md2 = Temporal.PlainMonthDay.from(mdStr);
JSON-Serialisierung und -Parsing
Dieses Beispiel zeigt, wie Temporal.PlainMonthDay ohne zusätzlichen Aufwand als JSON serialisiert und anschließend wieder geparst werden kann.
const md = Temporal.PlainMonthDay.from({ month: 8, day: 1 });
const jsonStr = JSON.stringify({ birthday: md }); // '{"birthday":"08-01"}'
const obj = JSON.parse(jsonStr, (key, value) => {
if (key === "birthday") {
return Temporal.PlainMonthDay.from(value);
}
return value;
});
Spezifikationen
| Spezifikation |
|---|
| Temporal # sec-temporal.plainmonthday.prototype.tojson |