Temporal.Instant.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.Instant Instanzen gibt ein neues Temporal.Instant Objekt zurück, das diesen Moment um eine angegebene Dauer (in einer Form, die durch Temporal.Duration.from() konvertierbar ist) rückwärts verschoben darstellt.

Wenn Sie zwei Instanzen 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 Dauer darstellt, die von diesem Moment subtrahiert werden soll. Es wird mit dem gleichen Algorithmus wie Temporal.Duration.from() in ein Temporal.Duration Objekt konvertiert.

Rückgabewert

Ein neues Temporal.Instant Objekt, das das Subtrahieren von duration von diesem Moment darstellt. Wenn duration positiv ist, dann ist der zurückgegebene Moment früher als dieser Moment; wenn duration negativ ist, dann ist der zurückgegebene Moment später als dieser Moment.

Ausnahmen

RangeError

Wird in einem der folgenden Fälle ausgelöst:

duration ist eine Kalenderdauer (sie hat eine nicht null years, months oder weeks), oder hat eine nicht null days, da Kalenderdauern ohne einen Kalender und Zeitreferenz mehrdeutig sind.
Das Ergebnis liegt nicht im darstellbaren Bereich, der ±10⁸ Tage oder etwa ±273.972,6 Jahre ab der Unix-Epoche umfasst.

const instant = Temporal.Instant.fromEpochMilliseconds(1000);
const duration = Temporal.Duration.from("PT1S"); // One-second duration
const newInstant = instant.subtract(duration);
console.log(newInstant.epochMilliseconds); // 0

Für weitere Beispiele siehe add().