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 von Temporal.Duration Instanzen gibt einen string mit einer sprachabhängigen Darstellung dieser Dauer zurück. 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 mit Lokalisierungsstrings durchgeführt werden, was potenziell ineffizient ist. Wenn die Methode viele Male 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 entscheiden kann, einen Teil der Datenbank zwischenzuspeichern, sodass zukünftige format Aufrufe nach Lokalisierungsstrings in einem stärker begrenzten 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 Formatierungskonventionen verwendet werden sollen.
In Implementierungen, die die Intl.DurationFormat API unterstützen, entsprechen diese Parameter genau den Parametern des Intl.DurationFormat() Konstruktors. Implementierungen ohne Unterstützung für Intl.DurationFormat geben genau 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
localesParameter desIntl.DurationFormat()Konstruktor. optionsOptional-
Ein Objekt, das das Ausgabeformat anpasst. Entspricht dem
optionsParameter desIntl.DurationFormat()Konstruktor.
Details zu diesen Parametern und wie sie verwendet werden, finden Sie im Intl.DurationFormat() Konstruktor.
Rückgabewert
Ein string, der die angegebene Dauer gemäß sprachspezifischen Konventionen darstellt.
In Implementierungen mit Intl.DurationFormat ist dies gleichbedeutend mit new Intl.DurationFormat(locales, options).format(duration).
Hinweis:
Meistens ist das von toLocaleString() zurückgegebene Format konsistent. Jedoch kann die Ausgabe zwischen Implementierungen unterschiedlich sein, selbst innerhalb derselben Lokalisierung — Ausgabevariationen sind designbedingt und durch die Spezifikation erlaubt. Sie entspricht möglicherweise auch nicht Ihren Erwartungen. Zum Beispiel kann 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()
Die grundlegende Verwendung dieser Methode ohne Angabe einer locale gibt einen formatierten string in der Standardlokalisierung 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 # sec-temporal.duration.prototype.tolocalestring |