Temporal.Instant.prototype.toJSON()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die toJSON()-Methode von Temporal.Instant-Instanzen gibt eine Zeichenkette zurück, die diesen Zeitpunkt im selben RFC 9557-Format darstellt, wie bei einem Aufruf von toString(). Sie wird implizit von JSON.stringify() aufgerufen.
Syntax
toJSON()
Parameter
Keine.
Rückgabewert
Eine Zeichenkette, die den gegebenen Zeitpunkt im RFC 9557-Format darstellt, mit so viel subsekundärer Prä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 in eine Zeichenkette umgewandelt wird. Diese Methode ist allgemein dazu gedacht, Temporal.Instant-Objekte bei der JSON-Serialisierung nützlich zu serialisieren, die dann mit der Funktion Temporal.Instant.from() als Reviver 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 und wieder geparst werden kann.
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 |