Temporal.PlainDateTime.prototype.until()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die Methode until() von Instanzen von Temporal.PlainDateTime gibt ein neues Temporal.Duration-Objekt zurück, das die Dauer von diesem Datum-Zeitpunkt zu einem anderen Datum-Zeitpunkt darstellt (in einer Form, die durch Temporal.PlainDateTime.from() konvertierbar ist). Die Dauer ist positiv, wenn der andere Datum-Zeitpunkt nach diesem liegt und negativ, wenn er davor liegt.
Diese Methode berechnet other - this. Um this - other durchzuführen, verwenden Sie die since()-Methode.
Syntax
until(other)
until(other, options)
Parameter
other-
Ein String, ein Objekt oder eine
Temporal.PlainDateTime-Instanz, die ein Datum-Zeitpunkt darstellt, von dem dieses Datum-Zeitpunkt subtrahiert werden soll. Es wird mit demselben Algorithmus wieTemporal.PlainDateTime.from()in einTemporal.PlainDateTime-Objekt konvertiert. Es muss denselben Kalender wiethishaben. optionsOptional-
Dieselben Optionen wie
since().
Rückgabewert
Ein neues Temporal.Duration-Objekt, das die Dauer von diesem Datum-Zeitpunkt bis other darstellt. Die Dauer ist positiv, wenn other nach diesem Datum-Zeitpunkt liegt, und negativ, wenn er 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()
let nextBilling = Temporal.PlainDateTime.from({
year: Temporal.Now.plainDateISO().year,
month: 4,
day: 1,
});
const now = Temporal.Now.plainDateTimeISO().round("second");
if (Temporal.PlainDateTime.compare(nextBilling, now) < 0) {
nextBilling = nextBilling.add({ years: 1 });
}
const duration = now.until(nextBilling);
console.log(`${duration.toLocaleString("en-US")} until next billing`);
Für weitere Beispiele siehe since().
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plaindatetime.prototype.until |