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 Methode since()
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 sie danach liegt.
Diese Methode führt this - other
aus. Um other - this
auszuführen, verwenden Sie die Methode until()
.
Syntax
since(other)
since(other, options)
Parameter
other
-
Ein String, ein Objekt oder eine
Temporal.PlainTime
-Instanz, die eine Zeit darstellt, die von dieser Zeit subtrahiert werden soll. Es wird mit demselben Algorithmus in einTemporal.PlainTime
-Objekt konvertiert wieTemporal.PlainTime.from()
. options
Optional-
Ein Objekt, das die Optionen für
Temporal.Duration.prototype.round()
enthält. Dazu gehörenlargestUnit
,roundingIncrement
,roundingMode
undsmallestUnit
.largestUnit
undsmallestUnit
akzeptieren nur die Einheiten:"hours"
,"minutes"
,"seconds"
,"milliseconds"
,"microseconds"
,"nanoseconds"
oder deren Singularformen. FürlargestUnit
bedeutet der Standardwert"auto"
"hours"
. FürsmallestUnit
ist 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 other
danach liegt.
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"
Runden des Ergebnisses
Standardmäßig wird der Bruchteil der smallestUnit
abgeschnitten. Sie können ihn mithilfe der roundingIncrement
- und roundingMode
-Optionen 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 proposal # sec-temporal.plaintime.prototype.since |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
since |
Legend
Tip: you can click/tap on a cell for more information.
- In development. Supported in a pre-release version.
- In development. Supported in a pre-release version.
- No support
- No support
- Experimental. Expect behavior to change in the future.
- See implementation notes.
- User must explicitly enable this feature.