Temporal.PlainTime.prototype.subtract()
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 Methode subtract()
von Temporal.PlainTime
-Instanzen gibt ein neues Temporal.PlainTime
-Objekt zurück, das diese Zeit um eine angegebene Dauer in der Vergangenheit verschoben darstellt (in einer Form, die durch Temporal.Duration.from()
konvertierbar ist), wobei es bei Bedarf um die Uhr wickelt.
Wenn Sie zwei Zeiten subtrahieren und eine Dauer erhalten möchten, verwenden Sie stattdessen since()
oder until()
.
Syntax
subtract(duration)
Parameter
duration
-
Ein String, ein Objekt oder eine
Temporal.Duration
-Instanz, die eine von dieser Zeit abzuziehende Dauer darstellt. Es wird mit dem gleichen Algorithmus wieTemporal.Duration.from()
in einTemporal.Duration
-Objekt konvertiert.
Rückgabewert
Ein neues Temporal.PlainTime
-Objekt, das die Zeit darstellt, die durch die ursprüngliche PlainTime
minus der Dauer bestimmt wird.
Das Subtrahieren einer Dauer ist gleichbedeutend mit dem Hinzufügen seiner Negation, daher gelten alle gleichen Überlegungen.
Beispiele
Subtrahieren einer Dauer
const start = Temporal.PlainTime.from("12:34:56");
const end = start.subtract({ hours: 1, minutes: 30 });
console.log(end.toString()); // 11:04:56
Für weitere Beispiele siehe add()
.
Spezifikationen
Specification |
---|
Temporal # sec-temporal.plaintime.prototype.subtract |