Temporal.Duration.prototype.total()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Die total()-Methode der Temporal.Duration-Instanzen gibt eine Zahl zurück, die die Gesamtdauer in der angegebenen Einheit darstellt.
Syntax
total(unit)
total(options)
Parameter
unit-
Ein String, der die
unit-Option darstellt. Dies ist eine Komfortüberladung, sodasstotal(unit)äquivalent zutotal({ unit })ist, wobeiunitein String ist. options-
Ein Objekt, das einige oder alle der folgenden Eigenschaften enthält (in der Reihenfolge, in der sie abgerufen und validiert werden):
relativeToOptional-
Ein zoniertes oder einfaches Datum(Zeit), das die Zeit- und Kalenderinformationen bereitstellt, um Kalenderdauern aufzulösen (siehe den Link für die allgemeine Interpretation dieser Option). Erforderlich, wenn entweder
diesoderandereeine Kalenderdauer ist oderuniteine Kalendereinheit ist. unit-
Eine der temporalen Einheiten:
"years","months","weeks","days","hours","minutes","seconds","milliseconds","microseconds","nanoseconds"oder ihre Singularformen.
Rückgabewert
Eine Fließkommazahl, die die Gesamtdauer in der angegebenen Einheit darstellt. Kann aufgrund von Begrenzungen der Fließkommagenauigkeit ungenau sein.
Ausnahmen
RangeError-
Ausgelöst in einem der folgenden Fälle:
unitwird nicht angegeben oder ist keine gültige Einheit.- Entweder
diesoderandereist eine Kalenderdauer, oderunitist eine Kalendereinheit, undrelativeTowird nicht angegeben.
Beschreibung
Wenn ein relativeTo angegeben wird, wird das Ergebnis berechnet, indem die Dauer zum Ausgangspunkt addiert wird, die Differenz zwischen dem Ergebnis und dem Ausgangspunkt (in Nanosekunden) ermittelt wird und dann die Differenz in die angeforderte Einheit umgewandelt wird, indem sie durch die entsprechende Anzahl von Nanosekunden pro Einheit geteilt wird. Die Angabe eines zonierten Datums-Zeitpunktes ermöglicht es, die Sommerzeit und andere Zeitzonenänderungen zu berücksichtigen; andernfalls werden 24-Stunden-Tage angenommen.
Wenn relativeTo nicht angegeben wird, wird das Ergebnis berechnet, indem die Dauer in Nanosekunden umgerechnet und durch die entsprechende Anzahl von Nanosekunden pro Einheit geteilt wird.
Beispiele
Verwendung von total()
const d = Temporal.Duration.from({ hours: 1, minutes: 30 });
console.log(d.total("minutes")); // 90
console.log(d.total("hours")); // 1.5
Gesamt einer Kalenderdauer
const d = Temporal.Duration.from({ months: 1 });
console.log(
d.total({ unit: "days", relativeTo: Temporal.PlainDate.from("2021-01-01") }),
); // 31
Spezifikationen
| Specification |
|---|
| Temporal # sec-temporal.duration.prototype.total |