Temporal.Instant.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.Instant Instanzen gibt ein neues Temporal.Duration Objekt zurück, das die Dauer von einem anderen Instant (in einer Form, die durch Temporal.Instant.from() umwandelbar ist) bis zu diesem Instant darstellt. Die Dauer ist positiv, wenn das andere Instant vor diesem Instant liegt, und negativ, wenn es danach liegt.

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

Syntax

js
since(other)
since(other, options)

Parameter

other

Ein String oder eine Temporal.Instant Instanz, die ein Instant darstellt, das von diesem Instant subtrahiert werden soll. Es wird mit demselben Algorithmus wie Temporal.Instant.from() in ein Temporal.Instant Objekt konvertiert.

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 nur die Einheiten: "hour", "minute", "second", "millisecond", "microsecond", "nanosecond" oder deren Pluralformen. Für largestUnit bedeutet der Standardwert "auto" entweder "second" oder smallestUnit, je nachdem, welches größer ist. Für smallestUnit ist der Standardwert "nanosecond".

Rückgabewert

Ein neues Temporal.Duration Objekt, das die Dauer seit other bis zu diesem Instant darstellt. Die Dauer ist positiv, wenn other vor diesem Instant ist, und negativ, wenn danach.

Ausnahmen

RangeError

Wird ausgelöst, wenn eine der Optionen ungültig ist.

Beispiele

Verwendung von since()

js
const lastUpdated = Temporal.Instant.fromEpochMilliseconds(1735235418000);
const now = Temporal.Now.instant();
const duration = now.since(lastUpdated, { smallestUnit: "minute" });
console.log(`Last updated ${duration.toLocaleString("en-US")} ago`);

Ausgleich der resultierenden Dauer

Da ein Instant keine Kalenderinformationen enthält, vermeidet die resultierende Dauer Kalenderdauern, die ohne Kalender- und Zeitreferenz mehrdeutig sind. Daher ist das Ergebnis unausgeglichen, da hours größer als 24 sein können. Um die Dauer auszugleichen, runden Sie die resultierende Dauer erneut mit der gewünschten largestUnit, indem Sie eine relativeTo angeben, die die Kalenderinformationen enthält.

js
const lastUpdated = Temporal.Instant.fromEpochMilliseconds(1735235418000);
const now = Temporal.Now.instant();
const duration = now.since(lastUpdated, { smallestUnit: "minute" });
const roundedDuration = duration.round({
  largestUnit: "year",
  // Use the ISO calendar; you can convert to another calendar using
  // withCalendar()
  relativeTo: now.toZonedDateTimeISO("UTC"),
});
console.log(`Last updated ${roundedDuration.toLocaleString("en-US")} ago`);

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch