Temporal.PlainDateTime.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 until() Methode von Temporal.PlainDateTime Instanzen gibt ein neues Temporal.Duration Objekt zurück, das die Dauer von diesem Datum-Uhrzeit bis zu einem anderen Datum-Uhrzeit darstellt (in einer Form, die durch Temporal.PlainDateTime.from() konvertierbar ist). Die Dauer ist positiv, wenn das andere Datum-Uhrzeit nach diesem Datum-Uhrzeit liegt, und negativ, wenn es davor 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 Zeichenkette, ein Objekt oder eine
Temporal.PlainDateTimeInstanz, die ein Datum-Uhrzeit darstellt, von dem dieses Datum-Uhrzeit subtrahiert werden soll. Es wird in einTemporal.PlainDateTimeObjekt umgewandelt, indem derselbe Algorithmus wieTemporal.PlainDateTime.from()verwendet wird. Es muss denselben Kalender wiethishaben. optionsOptional-
Dieselben Optionen wie
since().
Rückgabewert
Ein neues Temporal.Duration Objekt, das die Dauer von diesem Datum-Uhrzeit bis other darstellt. Die Dauer ist positiv, wenn other nach diesem Datum-Uhrzeit ist, 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()
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 |
Browser-Kompatibilität
Loading…