Temporal.PlainTime.prototype.since()
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 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) 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 durchzuführen, 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 subtrahiert 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 ihre Singularformen. 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
Nutzung 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"
Das Ergebnis Runden
Standardmäßig wird der Bruchteil der smallestUnit abgeschnitten. Sie können ihn 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 |
Browser-Kompatibilität
Loading…