Temporal.Duration.prototype.toLocaleString()
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 toLocaleString()-Methode der Temporal.Duration-Instanzen gibt eine zeichenbasierte Darstellung dieser Dauer zurück, die sprachspezifisch ist. In Implementierungen mit Unterstützung für die Intl.DurationFormat API delegiert diese Methode an Intl.DurationFormat.
Jedes Mal, wenn toLocaleString aufgerufen wird, muss eine Suche in einer großen Datenbank von Lokalisierungsstrings durchgeführt werden, was potenziell ineffizient ist. Wenn die Methode häufig mit denselben Argumenten aufgerufen wird, ist es besser, ein Intl.DurationFormat-Objekt zu erstellen und dessen format()-Methode zu verwenden, da ein DurationFormat-Objekt sich die übergebenen Argumente merkt und möglicherweise einen Teil der Datenbank zwischenspeichert, sodass zukünftige format-Aufrufe Lokalisierungsstrings in einem eingeschränkteren Kontext suchen können.
Syntax
toLocaleString()
toLocaleString(locales)
toLocaleString(locales, options)
Parameter
Die locales- und options-Parameter passen das Verhalten der Funktion an und ermöglichen es Anwendungen, die Sprache anzugeben, deren Formatierungsregeln verwendet werden sollen.
In Implementierungen, die die Intl.DurationFormat API unterstützen, entsprechen diese Parameter exakt den Parametern des Intl.DurationFormat()-Konstruktors. Implementierungen ohne Unterstützung für Intl.DurationFormat geben exakt denselben String zurück wie toString(), wobei beide Parameter ignoriert werden.
localesOptional-
Ein String mit einem BCP 47 Sprach-Tag oder ein Array solcher Strings. Entspricht dem
locales-Parameter desIntl.DurationFormat()-Konstruktors. optionsOptional-
Ein Objekt, das das Ausgabeformat anpasst. Entspricht dem
options-Parameter desIntl.DurationFormat()-Konstruktors.
Siehe den Intl.DurationFormat()-Konstruktor für Details zu diesen Parametern und wie man sie verwendet.
Rückgabewert
Ein String, der die angegebene Dauer gemäß sprachspezifischen Konventionen darstellt.
In Implementierungen mit Intl.DurationFormat entspricht dies new Intl.DurationFormat(locales, options).format(duration).
Hinweis:
Die vom toLocaleString() zurückgegebene Formatierung ist meistens konsistent. Allerdings kann die Ausgabe zwischen Implementierungen variieren, sogar innerhalb desselben Gebietsschemas — Abweichungen in der Ausgabe sind designbedingt und von der Spezifikation erlaubt. Sie entspricht möglicherweise auch nicht Ihrer Erwartung. Zum Beispiel könnte der String geschützte Leerzeichen verwenden oder von bidirektionalen Steuerzeichen umgeben sein. Sie sollten die Ergebnisse von toLocaleString() nicht mit fest codierten Konstanten vergleichen.
Beispiele
Verwendung von toLocaleString()
Grundlegende Nutzung dieser Methode ohne Angabe eines locale gibt einen formatierten String im Standardgebietsschema und mit Standardoptionen zurück.
const duration = Temporal.Duration.from({ hours: 1, minutes: 30, seconds: 15 });
console.log(duration.toLocaleString()); // 1 hr, 30 min, 15 sec
Spezifikationen
| Specification |
|---|
| Temporal proposal # sec-temporal.duration.prototype.tolocalestring |
Browser-Kompatibilität
BCD tables only load in the browser