Intl.DurationFormat.prototype.format()
Baseline
2025
Newly available
Since March 2025, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
Die format() Methode von Intl.DurationFormat Instanzen formatiert eine Dauer entsprechend der Lokalisierung und den Formatierungsoptionen dieses Intl.DurationFormat Objekts.
Syntax
Parameter
duration-
Das zu formatierende Dauerobjekt. Es sollte einige oder alle der folgenden Eigenschaften enthalten:
years,months,weeks,days,hours,minutes,seconds,milliseconds,microseconds,nanoseconds. Der Wert jeder Eigenschaft sollte eine ganze Zahl sein, und ihre Vorzeichen sollten konsistent sein. Dies kann einTemporal.DurationObjekt sein; sehen Sie in derTemporal.DurationDokumentation nach, um mehr über diese Eigenschaften zu erfahren.
Rückgabewert
Ein String, der die angegebene duration gemäß der Lokalisierung und den Formatierungsoptionen dieses Intl.DurationFormat Objekts formatiert darstellt.
Hinweis:
Die vom format() zurückgegebene Formatierung ist meistens konsistent. Allerdings kann die Ausgabe zwischen Implementierungen variieren, sogar innerhalb derselben Lokalisierung — solche Abweichungen sind beabsichtigt und von der Spezifikation erlaubt. Die Ausgabe entspricht möglicherweise auch nicht Ihren Erwartungen. Zum Beispiel könnte der String geschützte Leerzeichen verwenden oder von bidirektionalen Steuerzeichen umgeben sein. Sie sollten die Ergebnisse von format() nicht mit fest kodierten Konstanten vergleichen.
Beispiele
Verwendung von format()
Das folgende Beispiel zeigt, wie ein Dauerformatter mit der englischen Sprache erstellt wird.
Verwendung von format() mit unterschiedlichen Lokalisierungen und Stilen
Verwendung von format() mit der Option fractionalDigits
Spezifikationen
| Specification |
|---|
| Intl.DurationFormat # sec-Intl.DurationFormat.prototype.format |