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 Methode until() der 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 durch Temporal.Instant.from() konvertierbar ist). Die Dauer ist positiv, wenn der andere Zeitpunkt nach diesem Zeitpunkt liegt, und negativ, wenn er vorher liegt.
Diese Methode führt other - this aus. Um this - other durchzuführen, 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 wird. Er wird mit demselben Algorithmus wieTemporal.Instant.from()in einTemporal.Instant-Objekt konvertiert. optionsOptional-
Dieselben Optionen wie bei
since().
Rückgabewert
Ein neues Temporal.Duration-Objekt, das die Dauer von diesem Zeitpunkt bis zu other darstellt. Die Dauer ist positiv, wenn other nach diesem Zeitpunkt liegt, und negativ, wenn er vorher 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 proposal # sec-temporal.instant.prototype.until |
Browser-Kompatibilität
BCD tables only load in the browser