Temporal.PlainTime.prototype.since()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die since() Methode von Temporal.PlainTime Instanzen gibt ein neues Temporal.Duration Objekt zurück, das die Dauer von einer anderen Zeit (in einer Form, die durch Temporal.PlainTime.from() konvertierbar ist) bis zu dieser Zeit darstellt. Die Dauer ist positiv, wenn die andere Zeit vor dieser Zeit liegt, und negativ, wenn danach.
Diese Methode führt this - other aus. Um other - this zu berechnen, verwenden Sie die until() Methode.
Syntax
since(other)
since(other, options)
Parameter
other-
Ein String, ein Objekt oder eine
Temporal.PlainTimeInstanz, die eine Zeit darstellt, die von dieser Zeit abgezogen werden soll. Es wird mit dem gleichen Algorithmus wieTemporal.PlainTime.from()in einTemporal.PlainTimeObjekt konvertiert. optionsOptional-
Ein Objekt, das die Optionen für
Temporal.Duration.prototype.round()enthält, einschließlichlargestUnit,roundingIncrement,roundingModeundsmallestUnit.largestUnitundsmallestUnitakzeptieren nur die Einheiten:"hours","minutes","seconds","milliseconds","microseconds","nanoseconds"oder deren Einzahlformen. FürlargestUnitbedeutet der Standardwert"auto""hours". FürsmallestUnitist der Standardwert"nanoseconds".
Rückgabewert
Ein neues Temporal.Duration Objekt, das die Dauer seit other bis zu dieser Zeit darstellt. Die Dauer ist positiv, wenn other vor dieser Zeit liegt, und negativ, wenn danach.
Ausnahmen
RangeError-
Wird ausgelöst, wenn eine der Optionen ungültig ist.
Beispiele
Verwendung von since()
const lunchTime = Temporal.PlainTime.from("12:30:00");
const now = Temporal.Now.plainTimeISO();
const duration = now.since(lunchTime);
console.log(`You had lunch ${duration.toLocaleString("en-US")} ago`);
// Example output: "You had lunch 3 hr, 42 min, 21 sec, 343 ms, 131 μs, 718 ns ago"
const duration2 = now.since(lunchTime, { smallestUnit: "minutes" });
console.log(`You had lunch ${duration2.toLocaleString("en-US")} ago`);
// Example output: "You had lunch 3 hr, 42 min ago"
const duration3 = now.since(lunchTime, {
largestUnit: "minutes",
smallestUnit: "minutes",
});
console.log(`You had lunch ${duration3.toLocaleString("en-US")} ago`);
// Example output: "You had lunch 222 min ago"
Ergebnis runden
Standardmäßig wird der Bruchteil der smallestUnit abgeschnitten. Sie können diesen mit den Optionen roundingIncrement und roundingMode aufrunden.
const time1 = Temporal.PlainTime.from("12:30:00");
const time2 = Temporal.PlainTime.from("12:30:01");
const duration = time2.since(time1, {
smallestUnit: "seconds",
roundingIncrement: 15,
roundingMode: "ceil",
});
console.log(duration.toString()); // "PT15S"
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.plaintime.prototype.since |