Intl.DurationFormat
Baseline 2025>
Neu verfügbar
Seit März 2025 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Das Intl.DurationFormat-Objekt ermöglicht die sprachabhängige Formatierung von Zeitdauern.
Konstruktor
Intl.DurationFormat()-
Erstellt ein neues
Intl.DurationFormat-Objekt.
Statische Methoden
Intl.DurationFormat.supportedLocalesOf()-
Gibt ein Array mit den übergebenen Locales zurück, die unterstützt werden, ohne auf die Standard-Locale der Laufzeitumgebung zurückgreifen zu müssen.
Instanzeigenschaften
Diese Eigenschaften sind auf Intl.DurationFormat.prototype definiert und werden von allen Intl.DurationFormat-Instanzen gemeinsam genutzt.
Intl.DurationFormat.prototype.constructor-
Die Konstruktorfunktion, die das Instanzobjekt erstellt hat. Für
Intl.DurationFormat-Instanzen ist der Anfangswert der KonstruktorIntl.DurationFormat. Intl.DurationFormat.prototype[Symbol.toStringTag]-
Der Anfangswert der Eigenschaft
[Symbol.toStringTag]ist die Zeichenfolge"Intl.DurationFormat". Diese Eigenschaft wird inObject.prototype.toString()verwendet.
Instanzmethoden
Intl.DurationFormat.prototype.format()-
Formatiert eine Zeitdauer gemäß der Locale und den Formatierungsoptionen dieses
DurationFormat-Objekts. Intl.DurationFormat.prototype.formatToParts()-
Gibt ein
Arrayvon Objekten zurück, die die formatierte Zeitdauer in einzelnen Bestandteilen darstellen. Intl.DurationFormat.prototype.resolvedOptions()-
Gibt ein neues Objekt mit Eigenschaften zurück, die die bei der Initialisierung des Objekts ermittelten Locale- und Formatierungsoptionen widerspiegeln.
Beispiele
>Intl.DurationFormat verwenden
Die folgenden Beispiele zeigen, wie Sie mit dem Intl.DurationFormat-Objekt ein Zeitdauerobjekt für verschiedene Locales und Formatierungsstile 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);
// "1 h 46 min 40 s"
Spezifikationen
| Spezifikation |
|---|
| Intl.DurationFormat> # durationformat-objects> |