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 Instanzen des Temporal.Duration gibt eine Zahl zurück, die die Gesamtdauer in der angegebenen Einheit darstellt.

Syntax

total(unit)
total(options)

Parameter

unit

Ein String, der die Einheit Option darstellt. Dies ist eine Komfortüberladung, daher ist total(unit) gleichbedeutend mit total({ unit }), wobei unit ein String ist.

options

Ein Objekt, das einige oder alle der folgenden Eigenschaften enthält (in der Reihenfolge, in der sie abgerufen und validiert werden):

relativeTo Optional: Ein zonenbezogenes 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 this oder other eine Kalenderdauer ist oder unit eine Kalendereinheit ist.
unit: Eine der temporalen Einheiten: "years", "months", "weeks", "days", "hours", "minutes", "seconds", "milliseconds", "microseconds", "nanoseconds" oder deren Einzahlformen.

Rückgabewert

Eine Fließkommazahl, die die Gesamtdauer in der angegebenen Einheit darstellt. Kann aufgrund von Fließkommagenauigkeitsgrenzen ungenau sein.

Ausnahmen

RangeError

Wird in einem der folgenden Fälle ausgelöst:

unit wird nicht bereitgestellt oder ist keine gültige Einheit.
Entweder this oder other ist eine Kalenderdauer, oder unit ist eine Kalendereinheit und relativeTo wird nicht bereitgestellt.

Wenn ein relativeTo bereitgestellt wird, wird das Ergebnis berechnet, indem die Dauer zum Startpunkt hinzugefügt wird, die Differenz zwischen dem Ergebnis und dem Startpunkt (in Nanosekunden) ermittelt wird und dann die Differenz in die angeforderte Einheit umgerechnet wird, indem durch die entsprechende Anzahl von Nanosekunden pro Einheit geteilt wird. Das Bereitstellen einer zonengebundenen Uhrzeit ermöglicht auch die Berücksichtigung von Sommerzeit und anderen Zeitzonenänderungen; andernfalls werden 24-Stunden-Tage angenommen.

Wenn relativeTo nicht bereitgestellt wird, wird das Ergebnis berechnet, indem die Dauer in Nanosekunden umgerechnet und dann 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

Summe 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