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.Instant.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.Instant Instanzen gibt einen Zeichenfolgenwert zurück, der diesen Zeitpunkt im gleichen RFC 9557 Format darstellt, wie beim Aufruf von toString(). Diese Methode soll implizit von JSON.stringify() aufgerufen werden.

Syntax

js
toJSON()

Parameter

Keine.

Rückgabewert

Eine Zeichenfolge, die den gegebenen Zeitpunkt im RFC 9557 Format darstellt, mit so viel Subsekundenpräzision wie nötig, um die Dauer genau darzustellen, und mit dem UTC-Zeitzonenbezeichner Z.

Beschreibung

Die toJSON() Methode wird automatisch von JSON.stringify() aufgerufen, wenn ein Temporal.Instant Objekt als Zeichenfolge dargestellt wird. Diese Methode ist im Allgemeinen dazu gedacht, Temporal.Instant Objekte während der JSON Serialisierung nützlich zu serialisieren, was anschließend über die Temporal.Instant.from() Funktion als Reviver von JSON.parse() deserialisiert werden kann.

Beispiele

Verwendung von toJSON()

js
const instant = Temporal.Instant.fromEpochMilliseconds(1627821296000);
const instantStr = instant.toJSON(); // '2021-08-01T12:34:56Z'
const i2 = Temporal.Instant.from(instantStr);

JSON-Serialisierung und Parsing

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

js
const instant = Temporal.Instant.fromEpochMilliseconds(1627821296000);
const jsonStr = JSON.stringify({ time: instant }); // '{"time":"2021-08-01T12:34:56Z"}'
const obj = JSON.parse(jsonStr, (key, value) => {
  if (key === "time") {
    return Temporal.Instant.from(value);
  }
  return value;
});

Spezifikationen

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

Browser-Kompatibilität

Siehe auch