Temporal.PlainDate.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 des Temporal.PlainDate gibt ein neues Temporal.Duration Objekt zurück, das die Dauer von diesem Datum zu einem anderen Datum darstellt (in einer Form, die durch Temporal.PlainDate.from() konvertierbar ist). Die Dauer ist positiv, wenn das andere Datum nach diesem Datum liegt, und negativ, wenn es davor liegt.
Diese Methode führt other - this aus. Verwenden Sie die since() Methode, um this - other auszuführen.
Syntax
until(other)
until(other, options)
Parameter
other-
Ein String, ein Objekt oder eine Instanz von
Temporal.PlainDate, die ein Datum darstellt, von dem dieses Datum subtrahiert werden soll. Es wird mit demselben Algorithmus wieTemporal.PlainDate.from()in einTemporal.PlainDateObjekt konvertiert. Es muss denselben Kalender wiethishaben. optionsOptional-
Dieselben Optionen wie
since().
Rückgabewert
Ein neues Temporal.Duration Objekt, das die Dauer von diesem Datum bis other darstellt. Die Dauer ist positiv, wenn other nach diesem Datum liegt, und negativ, wenn es davor liegt.
Ausnahmen
RangeError-
Wird in einem der folgenden Fälle ausgelöst:
otherhat einen anderen Kalender alsthis.- Eine der Optionen ist ungültig.
Beispiele
Verwendung von until()
const launch = Temporal.PlainDate.from("2035-01-01");
const now = Temporal.Now.plainDateISO();
const duration = now.until(launch);
console.log(`It will be ${duration.toLocaleString("en-US")} until the launch`);
Für weitere Beispiele siehe since().
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plaindate.prototype.until |