Temporal.Instant.prototype.until()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die until() Methode von Instanzen von Temporal.Instant 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() umgewandelt werden kann). 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-
Ein String oder eine
Temporal.InstantInstanz, die einen Zeitpunkt darstellt, von dem dieser Zeitpunkt subtrahiert wird. Er wird mit demselben Algorithmus wieTemporal.Instant.from()in einTemporal.InstantObjekt umgewandelt. optionsOptional-
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: "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 |