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 eine Zeichenkette mit einer sprachsensitiven Darstellung dieser Dauer zurück. In Implementierungen mit Unterstützung der Intl.DurationFormat API delegiert diese Methode an Intl.DurationFormat.
Jedes Mal, wenn toLocaleString aufgerufen wird, muss eine Suche in einer großen Datenbank von Lokalisierungszeichenfolgen 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 entscheidet, einen Teil der Datenbank im Cache zu halten, sodass zukünftige format Aufrufe nach Lokalisierungszeichenfolgen in einem eingeschränkteren Kontext suchen können.
Syntax
toLocaleString()
toLocaleString(locales)
toLocaleString(locales, options)
Parameter
Die Parameter locales und options passen das Verhalten der Funktion an und lassen Anwendungen die Sprache angeben, 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 Intl.DurationFormat Unterstützung geben genau dieselbe Zeichenkette wie toString() zurück, während beide Parameter ignoriert werden.
localesOptional-
Ein String mit einem BCP 47 Sprach-Tag oder ein Array solcher Strings. Entspricht dem
localesParameter desIntl.DurationFormat()Konstruktors. optionsOptional-
Ein Objekt zur Anpassung des Ausgabeformats. Entspricht dem
optionsParameter desIntl.DurationFormat()Konstruktors.
Sehen Sie den Intl.DurationFormat() Konstruktor für Details zu diesen Parametern und deren Verwendung.
Rückgabewert
Eine Zeichenkette, die die angegebene Dauer gemäß sprachspezifischen Konventionen darstellt.
In Implementierungen mit Intl.DurationFormat entspricht dies new Intl.DurationFormat(locales, options).format(duration).
Hinweis:
Meistens ist das von toLocaleString() zurückgegebene Format konsistent. Die Ausgabe kann jedoch zwischen Implementierungen variieren, selbst innerhalb desselben Gebietsschemas — Variationen in der Ausgabe sind beabsichtigt und durch die Spezifikation erlaubt. Sie entspricht möglicherweise auch nicht Ihren Erwartungen. Zum Beispiel kann die Zeichenkette nicht-unterbrechbare Leerzeichen verwenden oder von bidirektionalen Steuerzeichen umgeben sein. Sie sollten die Ergebnisse von toLocaleString() nicht mit hartcodierten Konstanten vergleichen.
Beispiele
Verwendung von toLocaleString()
Die grundlegende Verwendung dieser Methode ohne Angabe eines locale liefert eine formatierte Zeichenkette im Standard-Gebietsschema und mit den Standardoptionen.
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 |