Temporal.ZonedDateTime.prototype.until()
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
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
| Spezifikation |
|---|
| Temporal # sec-temporal.zoneddatetime.prototype.until |