Temporal.PlainTime.prototype.subtract()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die subtract()-Methode von Temporal.PlainTime-Instanzen gibt ein neues Temporal.PlainTime-Objekt zurück, das diese Zeit um eine gegebene Dauer (in einer Form, die von Temporal.Duration.from() konvertiert werden kann) rückwärts verschoben darstellt und, falls erforderlich, die Uhr umwickelt.
Wenn Sie zwei Zeiten subtrahieren möchten, um eine Dauer zu erhalten, verwenden Sie stattdessen since() oder until().
Syntax
subtract(duration)
Parameter
duration-
Ein String, ein Objekt oder eine
Temporal.Duration-Instanz, die eine zu subtrahierende Dauer von dieser Zeit darstellt. Es wird mit dem gleichen Algorithmus wieTemporal.Duration.from()in einTemporal.Duration-Objekt konvertiert.
Rückgabewert
Ein neues Temporal.PlainTime-Objekt, das die durch die ursprüngliche PlainTime angegebene Zeit minus der Dauer darstellt.
Das Subtrahieren einer Dauer ist gleichbedeutend mit dem Hinzufügen ihrer 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
Weitere Beispiele finden Sie unter add().
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plaintime.prototype.subtract |