Temporal.PlainMonthDay.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 Temporal.PlainMonthDay-Instanzen gibt eine Zeichenkette zurück, die diesen Monats-Tag im selben RFC 9557-Format wie bei einem Aufruf von toString() darstellt. Sie soll implizit von JSON.stringify() aufgerufen werden.

Syntax

js
toJSON()

Parameter

Keine.

Rückgabewert

Eine Zeichenkette, die den angegebenen Monats-Tag im RFC 9557-Format darstellt, wobei das Jahr und der Kalendervermerk enthalten sind, wenn es sich nicht um "iso8601" handelt.

Beschreibung

Die toJSON()-Methode wird automatisch von JSON.stringify() aufgerufen, wenn ein Temporal.PlainMonthDay-Objekt in eine Zeichenkette umgewandelt wird. Diese Methode soll im Allgemeinen standardmäßig nützlich Temporal.PlainMonthDay-Objekte während der JSON-Serialisierung serialisieren, die dann mithilfe der Temporal.PlainMonthDay.from()-Funktion als Wiederherstellungsparameter von JSON.parse() deserialisiert werden können.

Beispiele

Verwendung von toJSON()

js
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 wieder zurückgeparst werden kann.

js
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

Specification
Temporal
# sec-temporal.plainmonthday.prototype.tojson

Browser-Kompatibilität

Siehe auch