Temporal.PlainDateTime.prototype.until()
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Want more support for this feature? Tell us why.
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
| Spezifikation |
|---|
| Temporal # sec-temporal.plaindatetime.prototype.until |