Temporal.PlainDate.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.PlainDate-Instanzen gibt einen String zurück, der dieses Datum 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

Ein String, der das angegebene Datum im RFC 9557-Format darstellt, mit der Kalenderannotation, wenn sie nicht "iso8601" ist.

Beschreibung

Die toJSON()-Methode wird automatisch von JSON.stringify() aufgerufen, wenn ein Temporal.PlainDate-Objekt serialisiert wird. Diese Methode ist im Allgemeinen dazu gedacht, Temporal.PlainDate-Objekte während der JSON-Serialisierung sinnvoll zu serialisieren, die dann mithilfe der Funktion Temporal.PlainDate.from() als Reviver von JSON.parse() deserialisiert werden können.

Beispiele

Verwendung von toJSON()

const date = Temporal.PlainDate.from({ year: 2021, month: 8, day: 1 });
const dateStr = date.toJSON(); // '2021-08-01'
const d2 = Temporal.PlainDate.from(dateStr);

JSON-Serialisierung und -Parsing

Dieses Beispiel zeigt, wie Temporal.PlainDate ohne zusätzlichen Aufwand als JSON serialisiert und wie es zurückgeparst werden kann.

const date = Temporal.PlainDate.from({ year: 2021, month: 8, day: 1 });
const jsonStr = JSON.stringify({ date }); // '{"date":"2021-08-01"}'
const obj = JSON.parse(jsonStr, (key, value) => {
  if (key === "date") {
    return Temporal.PlainDate.from(value);
  }
  return value;
});

Spezifikationen

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