Temporal.Duration.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.Duration
-Instanzen gibt einen String zurück, der diese Dauer im gleichen ISO 8601-Format darstellt wie der Aufruf von toString()
. Es ist vorgesehen, dass sie implizit durch JSON.stringify()
aufgerufen wird.
Syntax
toJSON()
Parameter
Keine.
Rückgabewert
Ein String, der die gegebene Dauer im ISO 8601-Format darstellt, mit so großer Untersekunden-Genauigkeit wie nötig, um die Dauer exakt darzustellen.
Beschreibung
Die toJSON()
-Methode wird automatisch von JSON.stringify()
aufgerufen, wenn ein Temporal.Duration
-Objekt in einen String umgewandelt wird. Diese Methode ist im Allgemeinen dazu gedacht, Temporal.Duration
-Objekte während der JSON-Serialisierung auf nützliche Weise standardmäßig zu serialisieren, die dann mit der Temporal.Duration.from()
-Funktion als Reviver von JSON.parse()
deserialisiert werden können.
Beispiele
Verwendung von toJSON()
const duration = Temporal.Duration.from({ hours: 1, minutes: 30, seconds: 15 });
const durationStr = duration.toJSON(); // 'PT1H30M15S'
const d2 = Temporal.Duration.from(durationStr);
JSON-Serialisierung und Parsing
Dieses Beispiel zeigt, wie Temporal.Duration
ohne zusätzlichen Aufwand als JSON serialisiert und wie es zurückgeparst werden kann.
const duration = Temporal.Duration.from({ hours: 1, minutes: 30, seconds: 15 });
const jsonStr = JSON.stringify({ data: duration }); // '{"data":"PT1H30M15S"}'
const obj = JSON.parse(jsonStr, (key, value) => {
if (key === "data") {
return Temporal.Duration.from(value);
}
return value;
});
Spezifikationen
Specification |
---|
Temporal proposal # sec-temporal.duration.prototype.tojson |