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 zu einem anderen Zeitpunkt darstellt (in einer Form, die durch Temporal.Instant.from() konvertierbar ist). Die Dauer ist positiv, wenn der andere Zeitpunkt nach diesem Zeitpunkt liegt, und negativ, wenn er davor liegt.
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-
Eine Zeichenkette oder eine
Temporal.Instant-Instanz, die einen Zeitpunkt darstellt, von dem dieser Zeitpunkt subtrahiert werden soll. Sie wird mit demselben Algorithmus in einTemporal.Instant-Objekt umgewandelt wieTemporal.Instant.from(). optionsOptional-
Die gleichen Optionen wie bei
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 er 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 |