Intl.DurationFormat
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Das Intl.DurationFormat
-Objekt ermöglicht die sprachsensitive Formatierung von Zeitspannen.
Konstruktor
Intl.DurationFormat()
-
Erstellt ein neues
Intl.DurationFormat
-Objekt.
Statische Methoden
Intl.DurationFormat.supportedLocalesOf()
-
Gibt ein Array zurück, das diejenigen der bereitgestellten Locale enthält, die unterstützt werden, ohne auf die standardmäßige Locale der Laufzeitumgebung zurückfallen zu müssen.
Instanz-Eigenschaften
Diese Eigenschaften sind auf Intl.DurationFormat.prototype
definiert und werden von allen Intl.DurationFormat
-Instanzen geteilt.
Intl.DurationFormat.prototype.constructor
-
Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für
Intl.DurationFormat
-Instanzen ist der Anfangswert derIntl.DurationFormat
-Konstruktor. Intl.DurationFormat.prototype[Symbol.toStringTag]
-
Der Anfangswert der
[Symbol.toStringTag]
-Eigenschaft ist der String"Intl.DurationFormat"
. Diese Eigenschaft wird inObject.prototype.toString()
verwendet.
Instanz-Methoden
Intl.DurationFormat.prototype.format()
-
Getter-Funktion, die eine Zeitspanne gemäß der Locale und den Formatierungsoptionen dieses
DurationFormat
-Objekts formatiert. Intl.DurationFormat.prototype.formatToParts()
-
Gibt ein
Array
von Objekten zurück, die die formatierte Zeitspanne in Teilen darstellen. Intl.DurationFormat.prototype.resolvedOptions()
-
Gibt ein neues Objekt mit Eigenschaften zurück, die die Locale und Formatierungsoptionen widerspiegeln, die während der Initialisierung des Objekts berechnet wurden.
Beispiele
Verwendung von Intl.DurationFormat
Die untenstehenden Beispiele zeigen, wie das Intl.DurationFormat
-Objekt verwendet wird, um ein Zeitspanne-Objekt mit verschiedenen Locales und Stilen zu formatieren.
const duration = {
hours: 1,
minutes: 46,
seconds: 40,
};
// With style set to "long" and locale "fr-FR"
new Intl.DurationFormat("fr-FR", { style: "long" }).format(duration);
// "1 heure, 46 minutes et 40 secondes"
// With style set to "short" and locale "en"
new Intl.DurationFormat("en", { style: "short" }).format(duration);
// "1 hr, 46 min and 40 sec"
// With style set to "narrow" and locale "pt"
new Intl.DurationFormat("pt", { style: "narrow" }).format(duration);
// "1h 46min 40s"
Spezifikationen
Specification |
---|
Intl.DurationFormat # durationformat-objects |
Browser-Kompatibilität
BCD tables only load in the browser