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 zeichenfolgenbasierte, sprachensensitive Darstellung dieser Dauer zurück. In Implementierungen mit Unterstützung der Intl.DurationFormat API wird diese Methode an Intl.DurationFormat delegiert.
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 die übergebenen Argumente speichert und möglicherweise einen Teil der Datenbank zwischenspeichert, sodass zukünftige format-Aufrufe nach Lokalisierungszeichenfolgen innerhalb eines eingeschränkteren Kontexts suchen können.
Syntax
toLocaleString()
toLocaleString(locales)
toLocaleString(locales, options)
Parameter
Die Parameter locales und options 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 Intl.DurationFormat-Unterstützung geben genau denselben String zurück wie toString() und ignorieren beide Parameter.
localesOptional-
Ein String mit einem BCP 47-Sprachcode 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 deren Verwendung.
Rückgabewert
Eine Zeichenkette, die die gegebene 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. Allerdings kann die Ausgabe zwischen verschiedenen Implementierungen variieren, selbst innerhalb derselben Sprache — Abweichungen sind beabsichtigt und durch die Spezifikation erlaubt. Es kann auch nicht das sein, was Sie erwarten. Zum Beispiel kann die Zeichenkette geschützte Leerzeichen verwenden oder von bidirektionalen Steuerzeichen umgeben sein. Sie sollten die Ergebnisse von toLocaleString() nicht mit festcodierten Konstanten vergleichen.
Beispiele
Verwendung von toLocaleString()
Die grundlegende Verwendung dieser Methode ohne eine angegebene locale gibt eine formatierte Zeichenkette in der Standard-Locale 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 |
Browser-Kompatibilität
Loading…