Temporal.PlainDateTime.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.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 das andere Datum-Zeit-Wert vor diesem liegt, und negativ, wenn es 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.PlainDateTime-Instanz, die ein Datum-Zeit-Wert darstellt, das von diesem subtrahiert wird. Es wird mit demselben 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, was größer ist. Für smallestUnit ist der Standardwert "nanoseconds". Das aktuelle Datum wird als die Option relativeTo verwendet. Beachten Sie, dass die Verwendung von Einheiten, die größer als "days" sind, die Dauer möglicherweise nicht auf andere Kalender oder Daten übertragbar macht.

Rückgabewert

Ein neues Temporal.Duration-Objekt, das die Dauer von other bis zu diesem Datum-Zeit-Wert darstellt. Die Dauer ist positiv, wenn other vor diesem Datum-Zeit-Wert liegt, und negativ, wenn es danach liegt.

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

js
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"

Ergebnis runden

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

js
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 proposal
# sec-temporal.plaindatetime.prototype.since

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
since
Experimental

Legend

Tip: you can click/tap on a cell for more information.

No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.
User must explicitly enable this feature.

Siehe auch