Temporal.Duration.prototype.toString()
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 toString()
-Methode von Temporal.Duration
Instanzen gibt einen String zurück, der diese Dauer im ISO 8601 Format darstellt.
Syntax
toString()
toString(options)
Parameter
options
Optional-
Ein Objekt, das einige oder alle der folgenden Eigenschaften enthält (in der Reihenfolge, in der sie abgerufen und validiert werden):
fractionalSecondDigits
Optional-
Entweder eine Ganzzahl von 0 bis 9 oder der String
"auto"
. Der Standardwert ist"auto"
. Wenn"auto"
, dann werden nachfolgende Nullen von den Bruchteilen der Sekunden entfernt. Andernfalls enthält der Bruchteil der Sekundenkomponente so viele Stellen, die nach Bedarf mit Nullen gefüllt oder gerundet werden. roundingMode
Optional-
Ein String, der angibt, wie Bruchteile der Sekunde, die über
fractionalSecondDigits
hinausgehen, gerundet werden sollen. SieheIntl.NumberFormat()
. Der Standardwert ist"trunc"
. smallestUnit
Optional-
Ein String, der die kleinste Einheit angibt, die in die Ausgabe aufgenommen werden soll. Mögliche Werte sind
"second"
,"millisecond"
,"microsecond"
und"nanosecond"
, oder ihre Pluralformen, diefractionalSecondDigits
-Werten von0
,3
,6
,9
entsprechen. Wenn angegeben, dann wirdfractionalSecondDigits
ignoriert.
Rückgabewert
Ein String, der die angegebene Dauer im ISO 8601 Format darstellt, wobei Unterschrittkomponenten gemäß den Optionen formatiert werden. Die Null-Dauer wird als "PT0S"
dargestellt.
Ausnahmen
RangeError
-
Wird ausgelöst, wenn eine der Optionen ungültig ist.
Beispiele
Verwendung von toString()
const duration = Temporal.Duration.from({ hours: 1, minutes: 30, seconds: 15 });
console.log(duration.toString()); // 'PT1H30M15S'
// Stringification implicitly calls toString()
console.log(`${duration}`); // 'PT1H30M15S'
Verwendung von Optionen
const worldRecord = Temporal.Duration.from({ seconds: 9, milliseconds: 580 });
console.log(worldRecord.toString()); // 'PT9.58S'
console.log(worldRecord.toString({ fractionalSecondDigits: 1 })); // 'PT9.5S'
console.log(worldRecord.toString({ fractionalSecondDigits: 0 })); // 'PT9S'
console.log(worldRecord.toString({ smallestUnit: "millisecond" })); // 'PT9.580S'
console.log(
worldRecord.toString({
fractionalSecondDigits: 1,
roundingMode: "halfExpand",
}),
); // 'PT9.6S'
Spezifikationen
Specification |
---|
Temporal # sec-temporal.duration.prototype.tostring |