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

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

Syntax

subtract(duration)
subtract(duration, options)

Parameter

duration

Ein String, ein Objekt oder eine Temporal.Duration-Instanz, die eine zu subtrahierende Dauer von diesem Jahr-Monat darstellt. Es wird in ein Temporal.Duration-Objekt umgewandelt, unter Verwendung des gleichen Algorithmus wie Temporal.Duration.from().

options Optional

Ein Objekt mit der folgenden Eigenschaft:

overflow Optional

Ein String, der das Verhalten angibt, wenn eine Datumskomponente außerhalb des gültigen Bereichs liegt. Mögliche Werte sind:

"constrain" (Standard): Die Datumskomponente wird auf den gültigen Bereich eingeschränkt.
"reject": Ein RangeError wird geworfen, wenn die Datumskomponente außerhalb des gültigen Bereichs liegt.

Rückgabewert

Ein neues Temporal.PlainYearMonth-Objekt, das den Jahr-Monat darstellt, der durch das ursprüngliche PlainYearMonth spezifiziert ist, minus der Dauer.

Beschreibung

Das Subtrahieren einer Dauer entspricht dem Addieren ihrer Negation, daher gelten alle gleichen Überlegungen. Das Subtrahieren einer positiven Dauer beginnt am Ende des Jahr-Monats und geht rückwärts, sodass jede Erhöhung, die kleiner ist als die Länge des Monats, ignoriert wird.

Beispiele

Subtrahieren einer Dauer

const start = Temporal.PlainYearMonth.from("2022-01");
const end = start.subtract({ years: 1, months: 2, weeks: 3, days: 4 });
console.log(end.toString()); // 2020-11

Weitere Beispiele finden Sie unter add().

Spezifikationen

Specification
Temporal proposal # sec-temporal.plainyearmonth.prototype.subtract

Browser-Kompatibilität

BCD tables only load in the browser