Temporal.PlainDateTime.prototype.since()

Syntax

since(other)
since(other, options)

Parameter

other

Ein String, ein Objekt oder eine Temporal.PlainDateTime-Instanz, die ein Datum-Uhrzeit repräsentiert, das von diesem Datum-Uhrzeit subtrahiert werden soll. Es wird mit dem gleichen Algorithmus in ein Temporal.PlainDateTime-Objekt konvertiert wie Temporal.PlainDateTime.from(). Es muss denselben Kalender wie this haben.

options Optional

Ein Objekt, das die Optionen für Temporal.Duration.prototype.round() enthält, einschließlich largestUnit, roundingIncrement, roundingMode und smallestUnit. largestUnit und smallestUnit akzeptieren alle möglichen Einheiten. Für largestUnit bedeutet der Standardwert "auto" entweder "days" oder smallestUnit, je nachdem, welches größer ist. Für smallestUnit ist der Standardwert "nanoseconds". Das aktuelle Datum wird als relativeTo Option verwendet. Beachten Sie, dass die Verwendung von Einheiten größer als "days" dazu führen kann, dass die Dauer nicht auf andere Kalender oder Daten übertragbar ist.

Rückgabewert

Ein neues Temporal.Duration-Objekt, das die Dauer seit other bis zu diesem Datum-Uhrzeit repräsentiert. Die Dauer ist positiv, wenn other vor diesem Datum-Uhrzeit 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

Verwendung von since()

let lastBilling = Temporal.PlainDateTime.from({
  year: Temporal.Now.plainDateISO().year,
  month: 4,
  day: 1,
});
const now = Temporal.Now.plainDateTimeISO().round("second");
if (Temporal.PlainDateTime.compare(lastBilling, now) > 0) {
  lastBilling = lastBilling.subtract({ years: 1 });
}
const duration = now.since(lastBilling);
console.log(`${duration.toLocaleString("en-US")} since last billing`);
// Expected output: "[number] days, [number] hr, [number] min, [number] sec since last billing"

const duration2 = now.since(lastBilling, { smallestUnit: "days" });
console.log(`${duration2.toLocaleString("en-US")} since last billing`);
// Expected output: "[number] days since last billing"

const duration3 = now.since(lastBilling, {
  largestUnit: "years",
  smallestUnit: "days",
});
console.log(`${duration3.toLocaleString("en-US")} since last billing`);
// Expected output: "[number] months, [number] days since last billing"

Runden des Ergebnisses

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

const dt1 = Temporal.PlainDateTime.from("2022-01-01T00:00:00");
const dt2 = Temporal.PlainDateTime.from("2022-01-28T12:34:56");
const duration = dt2.since(dt1, {
  smallestUnit: "days",
  roundingIncrement: 5,
  roundingMode: "ceil",
});
console.log(duration.toString()); // "P30D"

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Temporal.PlainDateTime
• Temporal.Duration
• Temporal.PlainDateTime.prototype.add()
• Temporal.PlainDateTime.prototype.subtract()
• Temporal.PlainDateTime.prototype.until()