Temporal.PlainTime.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.PlainTime Instanzen gibt ein neues Temporal.Duration Objekt zurück, das die Dauer von dieser Zeit bis zu einer anderen Zeit darstellt (in einer Form, die durch Temporal.PlainTime.from() umgewandelt werden kann). Die Dauer ist positiv, wenn die andere Zeit nach dieser liegt, und negativ, wenn sie davor liegt.
Diese Methode führt other - this aus. Um this - other auszuführen, verwenden Sie die Methode since().
Syntax
until(other)
until(other, options)
Parameter
other-
Ein String, ein Objekt oder eine
Temporal.PlainTimeInstanz, die eine Zeit darstellt, von der diese Zeit subtrahiert werden soll. Sie wird in einTemporal.PlainTimeObjekt umgewandelt, wobei derselbe Algorithmus wie beiTemporal.PlainTime.from()verwendet wird. Sie muss denselben Kalender haben wiethis. optionsOptional-
Dieselben Optionen wie bei
since().
Rückgabewert
Ein neues Temporal.Duration Objekt, das die Dauer von dieser Zeit bis other darstellt. Die Dauer ist positiv, wenn other nach dieser Zeit liegt, und negativ, wenn davor.
Ausnahmen
RangeError-
Wird ausgelöst, wenn eine der Optionen ungültig ist.
Beispiele
Verwendung von until()
const lunchTime = Temporal.PlainTime.from("12:30:00");
const now = Temporal.Now.plainTimeISO();
const duration = now.until(lunchTime);
console.log(`It will be ${duration.toLocaleString("en-US")} until lunch`);
// Example output: "It will be 3 hr, 42 min, 21 sec, 343 ms, 131 μs, 718 ns until lunch"
Für weitere Beispiele siehe since().
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plaintime.prototype.until |