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.Locale.prototype.firstDayOfWeek

Die Accessor-Eigenschaft firstDayOfWeek von Intl.Locale-Instanzen gibt den ersten Wochentag für diese Locale als Zeichenfolge zurück.

Beschreibung

Je nach Region und Kultur gelten unterschiedliche Regeln dafür, an welchem Tag die Woche beginnt. Dies wirkt sich unter anderem auf die Kalenderdarstellung und die Buchhaltung aus. Der Wert von firstDayOfWeek ist "mon", "tue", "wed", "thu", "fri", "sat" oder "sun".

Der Wert der Eigenschaft firstDayOfWeek wird bei der Erstellung festgelegt: entweder über den Schlüssel fw im Locale-Bezeichner oder über die Option firstDayOfWeek des Konstruktors Intl.Locale(). Wenn beide angegeben sind, hat die Option Vorrang. Ist keiner von beiden angegeben, hat die Eigenschaft den Wert undefined.

Der Set-Accessor von firstDayOfWeek ist undefined. Sie können diese Eigenschaft nicht direkt ändern.

Beispiele

Wie andere Locale-Subtags kann auch der erste Wochentag über die Locale-Zeichenfolge oder ein Konfigurationsobjekt als Argument des Konstruktors zum Intl.Locale-Objekt hinzugefügt werden.

Den ersten Wochentag über die Locale-Zeichenfolge hinzufügen

In der Spezifikation für Unicode-Locale-Zeichenfolgen ist firstDayOfWeek ein „Extension-Subtag“. Solche Subtags liefern zusätzliche Informationen zur Locale und werden Locale-Bezeichnern mithilfe des Extension-Schlüssels -u hinzugefügt. Um der ursprünglichen Locale-Zeichenfolge, die an den Konstruktor Intl.Locale() übergeben wird, den ersten Wochentag hinzuzufügen, fügen Sie zunächst den Extension-Schlüssel -u hinzu, falls er noch nicht vorhanden ist. Fügen Sie anschließend die Erweiterung -fw hinzu, um den ersten Wochentag anzugeben. Fügen Sie zuletzt den Namen des Tages hinzu.

js
const locale = new Intl.Locale("fr-FR-u-fw-thu");
console.log(locale.firstDayOfWeek); // "thu"

Den ersten Wochentag über das Konfigurationsobjekt hinzufügen

Der Konstruktor Intl.Locale() akzeptiert optional ein Konfigurationsobjekt als Argument. Dieses kann verschiedene Erweiterungen enthalten, darunter firstDayOfWeek. Setzen Sie die Eigenschaft firstDayOfWeek des Konfigurationsobjekts auf den gewünschten Tag und übergeben Sie das Objekt anschließend an den Konstruktor.

js
const locale = new Intl.Locale("fr-FR", { firstDayOfWeek: "thu" });
console.log(locale.firstDayOfWeek); // "thu"

Spezifikationen

Diese Funktion scheint in keiner Spezifikation definiert zu sein.

Browser-Kompatibilität

Siehe auch