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 Zeitpunkt (in einer Form, die durch Temporal.Instant.from() konvertierbar ist) zu diesem Zeitpunkt darstellt. Die Dauer ist positiv, wenn der andere Zeitpunkt vor diesem Zeitpunkt 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

since(other)
since(other, options)

Parameter

other: Ein String oder eine Temporal.Instant-Instanz, die einen Zeitpunkt darstellt, der von diesem Zeitpunkt 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, darunter largestUnit, roundingIncrement, roundingMode und smallestUnit. largestUnit und smallestUnit akzeptieren nur die Einheiten: "hours", "minutes", "seconds", "milliseconds", "microseconds", "nanoseconds" oder deren Singularformen. Für largestUnit bedeutet der Standardwert "auto" entweder "seconds" oder smallestUnit, je nachdem, welcher größer ist. Für smallestUnit ist der Standardwert "nanoseconds".

Rückgabewert

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

Ausnahmen

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

Beispiele

Verwendung von since()

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`);

Ausbalancieren der resultierenden Dauer

Da ein Zeitpunkt keine Kalenderinformationen enthält, vermeidet die resultierende Dauer Kalenderdauern, die ohne einen Kalender und Zeitreferenz mehrdeutig sind. Daher ist das Ergebnis unausgeglichen, weil 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 einen relativeTo übergeben, der die Kalenderinformationen enthält.

const lastUpdated = Temporal.Instant.fromEpochMilliseconds(1735235418000);
const now = Temporal.Now.instant();
const duration = now.since(lastUpdated, { smallestUnit: "minutes" });
const roundedDuration = duration.round({
  largestUnit: "years",
  // 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 # sec-temporal.instant.prototype.since