Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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 Konstruktor Intl.DurationFormat.

Intl.DurationFormat.prototype[Symbol.toStringTag]

Der Anfangswert der Eigenschaft [Symbol.toStringTag] ist die Zeichenfolge "Intl.DurationFormat". Diese Eigenschaft wird in Object.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 Array von 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.

js
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

Browser-Kompatibilität

Siehe auch