Temporal.ZonedDateTime.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 Temporal.ZonedDateTime Instanzen gibt ein neues Temporal.Duration Objekt zurück, das die Dauer von diesem Datum-Uhrzeit bis zu einem anderen Datum-Uhrzeit darstellt (in einem Format, das durch Temporal.ZonedDateTime.from() konvertierbar ist). Die Dauer ist positiv, wenn das andere Datum-Uhrzeit nach diesem liegt, und negativ, wenn es davor liegt.
Diese Methode führt other - this aus. Um this - other auszuführen, verwenden Sie die since() Methode.
Syntax
until(other)
until(other, options)
Parameter
other-
Ein String, ein Objekt oder eine
Temporal.ZonedDateTimeInstanz, die ein Datum-Uhrzeit darstellt, von dem diese Datum-Uhrzeit subtrahiert wird. Es wird in einTemporal.ZonedDateTimeObjekt konvertiert, indem derselbe Algorithmus wieTemporal.ZonedDateTime.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 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.
otherhat eine andere Zeitzone alsthis, undlargestUnitist"days"oder darüber.
Beispiele
Verwendung von until()
const flight = Temporal.ZonedDateTime.from(
"2024-12-21T13:31:00-05:00[America/New_York]",
);
const now = Temporal.Now.zonedDateTimeISO("America/New_York").round("second");
if (Temporal.ZonedDateTime.compare(flight, now) < 0) {
console.error(
"The flight is already in the past. The result may not make sense.",
);
}
const duration = now.until(flight, { largestUnit: "days" });
console.log(`The flight is in ${duration.toLocaleString("en-US")}`);
Für weitere Beispiele, siehe since().
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.zoneddatetime.prototype.until |