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 Zeitraum im selben RFC 9557 Format darstellt wie der Aufruf von toString(). Sie soll implizit von JSON.stringify() aufgerufen werden.

Syntax

toJSON()

Parameter

Keine.

Rückgabewert

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

Beschreibung

Die toJSON() Methode wird automatisch von JSON.stringify() aufgerufen, wenn ein Temporal.Instant Objekt als Zeichenfolge kodiert wird. Diese Methode ist im Allgemeinen dafür gedacht, dass Temporal.Instant Objekte standardmäßig nützlich während der JSON Serialisierung zu serialisieren, welche dann mithilfe der Temporal.Instant.from() Funktion als Wiederhersteller von JSON.parse() deserialisiert werden können.

Beispiele

Verwendung von toJSON()

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 werden kann und wie man es wieder einliest.

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