Temporal.PlainYearMonth.prototype.since()

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 since()-Methode von Temporal.PlainYearMonth-Instanzen gibt ein neues Temporal.Duration-Objekt zurück, das die Dauer zwischen einem anderen Jahr-Monat (in einer Form, die von Temporal.PlainYearMonth.from() konvertierbar ist) und diesem Jahr-Monat repräsentiert. Die Dauer ist positiv, wenn der andere Monat vor diesem Monat liegt, und negativ, wenn er danach liegt.

Diese Methode führt this - other aus. Um other - this auszuführen, verwenden Sie die until()-Methode.

Syntax

js
since(other)
since(other, options)

Parameter

other

Ein String, ein Objekt oder eine Temporal.PlainYearMonth-Instanz, die einen Jahr-Monat repräsentiert, der von diesem Jahr-Monat subtrahiert werden soll. Es wird mit demselben Algorithmus wie Temporal.PlainYearMonth.from() in ein Temporal.PlainYearMonth-Objekt konvertiert. Es muss denselben Kalender wie this haben.

options Optional

Ein Objekt, das die Optionen für Temporal.Duration.prototype.round() enthält, darunter largestUnit, roundingIncrement, roundingMode und smallestUnit. largestUnit und smallestUnit akzeptieren nur die Einheiten: "years", "months" oder deren Singularformen. Für largestUnit bedeutet der Standardwert "auto" "years". Für smallestUnit ist der Standardwert "months". Das aktuelle Datum wird als relativeTo-Option verwendet.

Rückgabewert

Ein neues Temporal.Duration-Objekt, das die Dauer seit other bis zu diesem Jahr-Monat repräsentiert. Die Dauer ist positiv, wenn other vor diesem Jahr-Monat liegt, und negativ, wenn danach.

Ausnahmen

RangeError

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

  • other hat einen anderen Kalender als this.
  • Eine der Optionen ist ungültig.

Beispiele

Verwenden von since()

js
const lastUpdated = Temporal.PlainYearMonth.from("2022-01");
const now = Temporal.Now.plainDateISO().toPlainYearMonth();
const duration = now.since(lastUpdated);
console.log(`Last updated ${duration.toLocaleString("en-US")} ago`);
// Expected output: "Last updated [number] years, [number] months ago"

const duration2 = now.since(lastUpdated, { largestUnit: "months" });
console.log(`Last updated ${duration2.toLocaleString("en-US")} ago`);
// Expected output: "Last updated [number] months ago"

const duration3 = now.since(lastUpdated, { smallestUnit: "years" });
console.log(`Last updated ${duration3.toLocaleString("en-US")} ago`);
// Expected output: "Last updated [number] years ago"

Abrunden des Ergebnisses

Standardmäßig wird der Bruchteil der smallestUnit abgeschnitten. Sie können ihn mithilfe der Optionen roundingIncrement und roundingMode aufrunden.

js
const ym1 = Temporal.PlainYearMonth.from("2022-01");
const ym2 = Temporal.PlainYearMonth.from("2022-11");
const duration = ym2.since(ym1, {
  smallestUnit: "years",
  roundingMode: "ceil",
});
console.log(duration.toString()); // "P1Y"

Ergebnis in Tagen abrufen

Standardmäßig enthält die resultierende Dauer niemals Tage, da PlainYearMonth keine Präzision auf Tagesebene bietet. Sie können das Ergebnis in Tagen erhalten, indem Sie es zunächst mit einem eindeutigen Tag in ein Temporal.PlainDate-Objekt konvertieren.

js
const ym1 = Temporal.PlainYearMonth.from("2022-01");
const ym2 = Temporal.PlainYearMonth.from("2022-11");
const duration = ym2.toPlainDate({ day: 1 }).since(ym1.toPlainDate({ day: 1 }));
console.log(duration.toString()); // "P304D"

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch