Temporal.PlainYearMonth.prototype.subtract()

duration

Ein String, ein Objekt oder eine Temporal.Duration-Instanz, die eine Dauer darstellt, die von diesem Jahr-Monat subtrahiert werden soll. Es wird mithilfe desselben Algorithmus wie Temporal.Duration.from() in ein Temporal.Duration-Objekt umgewandelt.

options Optional

Ein Objekt, das folgende Eigenschaft enthält:

overflow Optional

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

"constrain" (Standard)

Die Datums-Komponente wird auf den gültigen Bereich beschränkt (clamped).

"reject"

Es wird ein RangeError ausgelöst, wenn die Datums-Komponente außerhalb des Bereichs liegt.

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

RangeError

Wird ausgelöst, wenn das Ergebnis nicht im darstellbaren Bereich liegt, welcher ±(10⁸ + 1) Tage oder etwa ±273.972,6 Jahre ab der Unix-Epoche umfasst.

Das Subtrahieren einer Dauer entspricht dem Hinzufügen ihrer Negation, daher gelten dieselben Überlegungen. Das Subtrahieren einer positiven Dauer beginnt am Ende des Jahr-Monats und bewegt sich rückwärts, sodass jedes Inkrement, das kleiner als die Länge des Monats ist, ignoriert wird.

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().

• Temporal.PlainYearMonth
• Temporal.Duration
• Temporal.PlainYearMonth.prototype.add()
• Temporal.PlainYearMonth.prototype.since()
• Temporal.PlainYearMonth.prototype.until()