Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Temporal.PlainDateTime.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.PlainDateTime Instanzen gibt einen String zurück, der dieses Datum-Uhrzeit in demselben RFC 9557-Format darstellt, als würde man toString() aufrufen. Sie soll implizit von JSON.stringify() aufgerufen werden.

Syntax

js
toJSON()

Parameter

Keine.

Rückgabewert

Ein String, der das angegebene Datum-Uhrzeit in dem 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.PlainDateTime-Objekt in einen String umgewandelt wird. Diese Methode ist allgemein dazu gedacht, Temporal.PlainDateTime-Objekte während der JSON-Serialisierung nützlich zu serialisieren, die dann mit der Funktion Temporal.PlainDateTime.from() als Reviver von JSON.parse() deserialisiert werden kann.

Beispiele

Verwendung von toJSON()

js
const dt = Temporal.PlainDateTime.from({ year: 2021, month: 8, day: 1 });
const dtStr = dt.toJSON(); // '2021-08-01T00:00:00'
const dt2 = Temporal.PlainDateTime.from(dtStr);

JSON-Serialisierung und -Parsing

Dieses Beispiel zeigt, wie Temporal.PlainDateTime ohne zusätzlichen Aufwand als JSON serialisiert und wie es wieder geparst werden kann.

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

Spezifikationen

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

Browser-Kompatibilität

Siehe auch