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 mit Temporal.Instant.from() konvertierbar ist) bis 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 repräsentiert, der von diesem Zeitpunkt abgezogen werden soll. Es wird mit demselben Algorithmus wie Temporal.Instant.from() in ein Temporal.Instant Objekt umgewandelt.
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: "hours", "minutes", "seconds", "milliseconds", "microseconds", "nanoseconds" oder ihre Singularformen. Für largestUnit bedeutet der Standardwert "auto" "seconds" oder smallestUnit, je nachdem, was 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 repräsentiert. 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`);

Ausgleichen der resultierenden Dauer

Da ein Zeitpunkt keine Kalenderinformationen enthält, vermeidet die resultierende Dauer Kalenderdauern, die ohne 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, und geben Sie einen relativeTo an, 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