Temporal.Instant.prototype.until()

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

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

Syntax

until(other)
until(other, options)

Parameter

other: Ein String oder eine Temporal.Instant Instanz, die einen Moment darstellt, von dem dieser Instant subtrahiert werden soll. Er wird in ein Temporal.Instant Objekt umgewandelt mit demselben Algorithmus wie Temporal.Instant.from().
options Optional: Die gleichen Optionen wie bei since().

Rückgabewert

Ein neues Temporal.Duration Objekt, das die Dauer von diesem Instant bis other darstellt. Die Dauer ist positiv, wenn other nach diesem liegt, und negativ, wenn es davor liegt.

Ausnahmen

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

Beispiele

Verwendung von until()

const launch = Temporal.Instant.fromEpochMilliseconds(2051222400000);
const now = Temporal.Now.instant();
const duration = now.until(launch, { smallestUnit: "minutes" });
console.log(`It will be ${duration.toLocaleString("en-US")} until the launch`);

Für weitere Beispiele siehe since().

Spezifikationen

Specification
Temporal # sec-temporal.instant.prototype.until