Temporal.PlainDateTime.prototype.since()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die since() Methode von Temporal.PlainDateTime Instanzen gibt ein neues Temporal.Duration Objekt zurück, das die Dauer von einem anderen Datum-Zeit-Wert (in einer Form, die durch Temporal.PlainDateTime.from() konvertierbar ist) bis zu diesem Datum-Zeit-Wert darstellt. Die Dauer ist positiv, wenn der andere Zeitpunkt vor diesem Zeitpunkt liegt, und negativ, wenn er danach liegt.

Diese Methode entspricht this - other. Um other - this durchzuführen, verwenden Sie die until() Methode.

Syntax

since(other)
since(other, options)

Parameter

other: Ein String, ein Objekt oder eine Temporal.PlainDateTime Instanz, die einen Datum-Zeit-Wert darstellt, von dem dieser Datum-Zeit-Wert abgezogen werden soll. Es wird unter Verwendung desselben Algorithmus wie Temporal.PlainDateTime.from() in ein Temporal.PlainDateTime Objekt konvertiert. 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" "days" oder smallestUnit, je nachdem, welcher 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" die Dauer möglicherweise nicht portabel für andere Kalender oder Daten machen kann.

Rückgabewert

Ein neues Temporal.Duration Objekt, das die Dauer seit other bis zu diesem Datum-Zeit-Wert darstellt. Die Dauer ist positiv, wenn other vor diesem Datum-Zeit-Wert 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 mit den 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

Specification
Temporal # sec-temporal.plaindatetime.prototype.since

Browser-Kompatibilität

Siehe auch

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden