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 Zeitpunkt bis zu einem anderen Zeitpunkt darstellt (in einer Form, die von Temporal.Instant.from() konvertierbar ist). Die Dauer ist positiv, wenn der andere Zeitpunkt nach diesem Zeitpunkt liegt, und negativ, wenn davor.

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

Syntax

until(other)
until(other, options)

Parameter

other: Ein String oder eine Temporal.Instant Instanz, die einen Zeitpunkt darstellt, von dem dieser Zeitpunkt abgezogen werden soll. Es wird mit demselben Algorithmus wie Temporal.Instant.from() in ein Temporal.Instant Objekt konvertiert.
options Optional: Dieselben Optionen wie since().

Rückgabewert

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

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: "minute" });
console.log(`It will be ${duration.toLocaleString("en-US")} until the launch`);

Für weitere Beispiele siehe since().

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser