Intl.DurationFormat() Konstruktor

Syntax

new Intl.DurationFormat()
new Intl.DurationFormat(locales)
new Intl.DurationFormat(locales, options)

Parameter

locales Optional

Ein String mit einem BCP 47 Sprach-Tag oder eine Intl.Locale Instanz, oder ein Array solcher Gebietsschema-Bezeichner. Das Standard-Gebietsschema der Laufzeit wird verwendet, wenn undefined übergeben wird oder wenn keiner der angegebenen Gebietsschema-Bezeichner unterstützt wird. Für die allgemeine Form und Interpretation des locales Arguments siehe die Parameterbeschreibung auf der Intl Hauptseite.

Der folgende Unicode-Erweiterungsschlüssel ist erlaubt:

nu

Siehe numberingSystem.

Dieser Schlüssel kann auch mit options gesetzt werden (wie unten aufgeführt). Wenn beide gesetzt sind, hat die options Eigenschaft Vorrang.

options Optional

Ein Objekt, das die folgenden Eigenschaften enthält, in der Reihenfolge, in der sie abgerufen werden (alle sind optional):

localeMatcher

Der zu verwendende Gebietsschema-Abgleichalgorithmus. Mögliche Werte sind "lookup" und "best fit"; der Standardwert ist "best fit". Für Informationen zu dieser Option siehe Locale-Identifikation und -Verhandlung.

numberingSystem

Das zu verwendende Nummerierungssystem zur Zahlenformatierung, wie z.B. "arab", "hans", "mathsans", usw. Eine Liste der unterstützten Nummerierungssystemtypen finden Sie in Intl.supportedValuesOf(); der Standardwert ist landesabhängig. Diese Option kann auch über den nu Unicode-Erweiterungsschlüssel gesetzt werden; wenn beide angegeben sind, hat diese options Eigenschaft Vorrang.

style

Der Stil der formatierten Dauer. Dieser Wert wird als Standard für alle anderen Einheitenoptionen verwendet und entspricht auch der style Option von Intl.ListFormat() beim Verketten der Liste von Dauereinheiten. Mögliche Werte sind:

"long"

Z.B., 1 Stunde und 50 Minuten

"short" (Standard)

Z.B., 1 Std., 50 Min.

"narrow"

Z.B., 1h 50m

"digital"

Z.B., 1:50:00

years

Der Stil der formatierten Jahre. Mögliche Werte sind "long", "short" und "narrow"; der Standardwert ist options.style, wenn es nicht "digital" ist, und "short" andernfalls.

yearsDisplay

Ob Jahre immer angezeigt werden sollen oder nur, wenn sie nicht null sind. Mögliche Werte sind "always" und "auto"; der Standardwert ist "auto", wenn years nicht angegeben ist, und "always" andernfalls.

months

Der Stil der formatierten Monate. Mögliche Werte sind "long", "short" und "narrow"; der Standardwert ist options.style, wenn es nicht "digital" ist, und "short" andernfalls.

monthsDisplay

Ob Monate immer angezeigt werden sollen oder nur, wenn sie nicht null sind. Mögliche Werte sind "always" und "auto"; der Standardwert ist "auto", wenn months nicht angegeben ist, und "always" andernfalls.

weeks

Der Stil der formatierten Wochen. Mögliche Werte sind "long", "short" und "narrow"; der Standardwert ist options.style, wenn es nicht "digital" ist, und "short" andernfalls.

weeksDisplay

Ob Wochen immer angezeigt werden sollen oder nur, wenn sie nicht null sind. Mögliche Werte sind "always" und "auto"; der Standardwert ist "auto", wenn weeks nicht angegeben ist, und "always" andernfalls.

days

Der Stil der formatierten Tage. Mögliche Werte sind "long", "short" und "narrow"; der Standardwert ist options.style, wenn es nicht "digital" ist, und "short" andernfalls.

daysDisplay

Ob Tage immer angezeigt werden sollen oder nur, wenn sie nicht null sind. Mögliche Werte sind "always" und "auto"; der Standardwert ist "auto", wenn days nicht angegeben ist, und "always" andernfalls.

hours

Der Stil der formatierten Stunden. Mögliche Werte sind "long", "short", "narrow", "numeric" und "2-digit"; der Standardwert ist options.style, wenn es nicht "digital" ist, und "numeric" andernfalls.

hoursDisplay

Ob Stunden immer angezeigt werden sollen oder nur, wenn sie nicht null sind. Mögliche Werte sind "always" und "auto"; der Standardwert ist "auto", wenn hours nicht angegeben ist und options.style nicht "digital" ist, und "always" andernfalls.

minutes

Der Stil der formatierten Minuten.

• Wenn hours "numeric" oder "2-digit" ist, sind mögliche Werte "numeric" und "2-digit", und "numeric" wird zu "2-digit" normalisiert; der Standardwert ist "numeric".
• Ansonsten sind mögliche Werte "long", "short", "narrow", "numeric" und "2-digit"; der Standardwert ist options.style, wenn es nicht "digital" ist, und "numeric" andernfalls.

minutesDisplay

Ob Minuten immer angezeigt werden sollen oder nur, wenn sie nicht null sind. Mögliche Werte sind "always" und "auto"; der Standardwert ist "auto", wenn minutes nicht angegeben ist und options.style nicht "digital" ist, und "always" andernfalls.

seconds

Der Stil der formatierten Sekunden.

• Wenn minutes "numeric" oder "2-digit" ist, sind mögliche Werte "numeric" und "2-digit", und "numeric" wird zu "2-digit" normalisiert; der Standardwert ist "numeric".
• Ansonsten sind mögliche Werte "long", "short", "narrow", "numeric" und "2-digit"; der Standardwert ist options.style, wenn es nicht "digital" ist, und "numeric" andernfalls.

secondsDisplay

Ob Sekunden immer angezeigt werden sollen oder nur, wenn sie nicht null sind. Mögliche Werte sind "always" und "auto"; der Standardwert ist "auto", wenn seconds nicht angegeben ist und options.style nicht "digital" ist, und "always" andernfalls.

milliseconds

Der Stil der formatierten Millisekunden.

• Wenn seconds "numeric" oder "2-digit" ist, ist der einzige mögliche Wert "numeric"; der Standardwert ist "numeric".
• Ansonsten sind mögliche Werte "long", "short", "narrow" und "numeric"; der Standardwert ist options.style, wenn es nicht "digital" ist, und "numeric" andernfalls.

millisecondsDisplay

Ob Millisekunden immer angezeigt werden sollen oder nur, wenn sie nicht null sind.

• Wenn seconds "numeric" oder "2-digit" ist, ist der einzige mögliche Wert "auto"; der Standardwert ist nur dann "auto", wenn milliseconds nicht angegeben ist.
• Ansonsten sind mögliche Werte "always" und "auto"; der Standardwert ist "auto", wenn milliseconds nicht angegeben ist, und "always" andernfalls.

microseconds

Der Stil der formatierten Mikrosekunden.

• Wenn milliseconds "numeric" ist, ist der einzige mögliche Wert "numeric"; der Standardwert ist "numeric".
• Ansonsten sind mögliche Werte "long", "short", "narrow" und "numeric"; der Standardwert ist options.style, wenn es nicht "digital" ist, und "numeric" andernfalls.

microsecondsDisplay

Ob Mikrosekunden immer angezeigt werden sollen oder nur, wenn sie nicht null sind.

• Wenn milliseconds "numeric" ist, ist der einzige mögliche Wert "auto"; der Standardwert ist nur dann "auto", wenn microseconds nicht angegeben ist.
• Ansonsten sind mögliche Werte "always" und "auto"; der Standardwert ist "auto", wenn microseconds nicht angegeben ist, und "always" andernfalls.

nanoseconds

Der Stil der formatierten Nanosekunden.

• Wenn microseconds "numeric" ist, ist der einzige mögliche Wert "numeric"; der Standardwert ist "numeric".
• Ansonsten sind mögliche Werte "long", "short", "narrow" und "numeric"; der Standardwert ist options.style, wenn es nicht "digital" ist, und "numeric" andernfalls.

nanosecondsDisplay

Ob Nanosekunden immer angezeigt werden sollen oder nur, wenn sie nicht null sind.

• Wenn microseconds "numeric" ist, ist der einzige mögliche Wert "auto"; der Standardwert ist nur dann "auto", wenn nanoseconds nicht angegeben ist.
• Ansonsten sind mögliche Werte "always" und "auto"; der Standardwert ist "auto", wenn nanoseconds nicht angegeben ist, und "always" andernfalls.

fractionalDigits

Anzahl der anzuzeigenden Nachkommastellen im Ausgabeformat. Mögliche Werte sind von 0 bis 9; der Standardwert ist undefined (einschließlich aller erforderlichen Nachkommazahlen).

Ausnahmen

RangeError

Wird ausgelöst, wenn locales oder options ungültige Werte enthalten.

Beschreibung

Für jedes Zeitsegment wird intern ein Intl.NumberFormat Objekt konstruiert. Es verwendet die folgenden Optionen (siehe Intl.NumberFormat() für Details):

• numberingSystem: der Wert von options.numberingSystem

Wenn milliseconds, microseconds oder nanoseconds den "numeric" Stil verwenden, werden auch die folgenden Optionen verwendet:

• minimumFractionDigits: 0 wenn options.fractionalDigits undefined ist, ansonsten options.fractionalDigits
• maximumFractionDigits: 9 wenn options.fractionalDigits undefined ist, ansonsten options.fractionalDigits
• roundingMode: "trunc"

Wenn das Zeitsegment den "2-digit" Stil verwendet, werden auch die folgenden Optionen verwendet:

• minimumIntegerDigits: 2

Wenn das Zeitsegment den Stil "long", "short" oder "narrow" verwendet, werden auch die folgenden Optionen verwendet:

• style: "unit" wenn "long", "short" oder "narrow" angegeben ist, andernfalls undefined
• unit: die aktuell formatierte Einheit ("years", "days", "nanoseconds", etc.)
• unitDisplay: der Wert des Zeitsegment-Stils ("long", "short" oder "narrow")

Beispiele

Verwendung des Intl.DurationFormat() Konstruktors

const duration = {
  hours: 2,
  minutes: 20,
  seconds: 35,
};

console.log(new Intl.DurationFormat("pt", { style: "long" }).format(duration));
// "2 horas, 20 minutos e 35 segundos"

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Intl.DurationFormat
• Intl.supportedValuesOf()
• Intl