Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 subtract() Methode von Temporal.PlainTime Instanzen gibt ein neues Temporal.PlainTime Objekt zurück, das die Zeit darstellt, die um eine gegebene Dauer (in einer Form, die durch Temporal.Duration.from() konvertierbar ist) zurückverschoben wurde, wobei bei Bedarf die Uhr umgangen wird.

Wenn Sie zwei Zeiten subtrahieren und eine Dauer erhalten möchten, verwenden Sie stattdessen since() oder until().

Syntax

js
subtract(duration)

Parameter

duration

Ein String, ein Objekt oder eine Temporal.Duration Instanz, die eine von dieser Zeit abzuziehende Dauer repräsentiert. Es wird mit demselben Algorithmus wie Temporal.Duration.from() in ein Temporal.Duration Objekt konvertiert.

Rückgabewert

Ein neues Temporal.PlainTime Objekt, das die durch das ursprüngliche PlainTime angegebene Zeit minus der Dauer darstellt.

Das Subtrahieren einer Dauer ist gleichbedeutend mit dem Addieren ihrer Negation, daher gelten alle gleichen Überlegungen.

Beispiele

Subtraktion einer Dauer

js
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

Browser-Kompatibilität

Siehe auch