Temporal.Duration.prototype.total()
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 total()-Methode von 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 bequeme Überladung, sodasstotal(unit)gleichbedeutend mittotal({ 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 normales Datum(Zeit), das die Zeit- und Kalenderinformationen bereitstellt, um Kalenderdauern aufzulösen (sehen Sie sich den Link für die allgemeine Interpretation dieser Option an). Erforderlich, wenn entweder
thisoderothereine Kalenderdauer ist oderuniteine Kalendereinheit ist. unit-
Eine der temporalen Einheiten:
"years","months","weeks","days","hours","minutes","seconds","milliseconds","microseconds","nanoseconds"oder ihre Einzelformen.
Rückgabewert
Eine Gleitkommazahl, die die Gesamtdauer in der angegebenen Einheit darstellt. Kann aufgrund von Gleitkomma-Präzisionsgrenzen ungenau sein.
Ausnahmen
RangeError-
Wird in einem der folgenden Fälle ausgelöst:
unitwird nicht angegeben oder ist keine gültige Einheit.- Entweder
thisoderotherist eine Kalenderdauer, oderunitist eine Kalendereinheit, undrelativeTowird nicht angegeben.
Beschreibung
Wenn ein relativeTo angegeben wird, wird das Ergebnis berechnet, indem die Dauer zum Startpunkt hinzugefügt, die Differenz zwischen dem Ergebnis und dem Startpunkt (in Nanosekunden) ermittelt und die Differenz durch die entsprechende Anzahl von Nanosekunden pro Einheit geteilt wird, um die angeforderte Einheit zu erhalten. Wenn ein zoniertes Datum-Uhrzeit angegeben wird, können auch die Sommerzeit und andere Zeitzonenänderungen berücksichtigt werden; andernfalls werden 24-Stunden-Tage angenommen.
Wenn relativeTo nicht angegeben wird, wird das Ergebnis berechnet, indem die Dauer in Nanosekunden umgewandelt 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
Gesamtdauer 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 |
Browser-Kompatibilität
Loading…