Locale QML Type

Stellt lokalisierungsspezifische Eigenschaften und formatierte Daten bereit. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder
• Veraltete Elemente

Eigenschaften

• amText : string
• decimalPoint : string
• exponential : string
• firstDayOfWeek : enumeration
• groupSeparator : string
• measurementSystem : enumeration
• name : string
• nativeLanguageName : string
• nativeTerritoryName : string
• negativeSign : string
• numberOptions : enumeration
• percent : string
• pmText : string
• positiveSign : string
• textDirection : enumeration
• uiLanguages : Array<string>
• weekDays : Array<int>
• zeroDigit : string

Methoden

• string createSeparatedList(list<string> list) (since 6.10)
• string currencySymbol(format)
• string dateFormat(type)
• string dateTimeFormat(type)
• string dayName(day, type)
• string formattedDataSize(int bytes, int precision, DataSizeFormat format) (since 6.2)
• string monthName(month, type)
• string standaloneDayName(day, type)
• string standaloneMonthName(month, type)
• string timeFormat(type)
• string toString(int i) (since 6.5)
• string toString(Date date, FormatType format) (since 6.5)
• string toString(Date date, string format) (since 6.5)
• string toString(double f, char format, int precision) (since 6.5)

Ausführliche Beschreibung

Das Locale-Objekt darf nur über die Funktion ` Qt.locale()` erstellt werden. Es kann nicht direkt erstellt werden.

Die Funktion ` Qt.locale()` gibt ein JS-Locale-Objekt zurück, das die Locale mit dem angegebenen Namen repräsentiert, der das Format „Sprache[_Gebiet][.Zeichensatz][@Modifikator]“ oder „C“ hat.

„Locale“ unterstützt das Konzept einer Standard-Locale, die beim Start der Anwendung anhand der Locale-Einstellungen des Systems ermittelt wird. Wird kein Parameter an `Qt.locale()` übergeben, wird das Standard-Locale-Objekt zurückgegeben.

Das Locale-Objekt stellt eine Reihe von Funktionen und Eigenschaften bereit, die Daten für die angegebene Locale liefern.

Das Locale-Objekt kann auch an die Methoden `toLocaleString()` und `fromLocaleString()` der Klassen `Date ` und `Number` übergeben werden, um unter Verwendung der angegebenen Locale in Zeichenketten zu konvertieren oder aus diesen zu konvertieren.

Dieses Beispiel zeigt das aktuelle Datum, formatiert für die deutsche Sprachumgebung:

import QtQuick 2.0

Text {
    text: "The date is: " + Date().toLocaleString(Qt.locale("de_DE"))
}

Das folgende Beispiel zeigt die angegebene Zahl im korrekten Format für die Standard-Locale an:

import QtQuick 2.0

Text {
    text: "The value is: " + Number(23443.34).toLocaleString(Qt.locale())
}

Qt Quick Die Daten der Locale basieren auf dem Common Locale Data Repository v1.8.1.

Formattypen für Locale-Zeichenfolgen

Die Methoden „ monthName()“, „ standaloneMonthName()“, „ dayName()“ und „ standaloneDayName()“ können die folgenden Aufzählungswerte verwenden, um die Formatierung der Zeichenfolgendarstellung für ein „Date“-Objekt festzulegen.

Darüber hinaus unterliegen die Konvertierungsfunktionen von „double“ zu „string“ und von „string“ zu „double“ den folgenden Lizenzen:

Siehe auch das JavaScript-Objekt „Date “ und das JavaScript-Objekt „Number“.

Dokumentation zu den Eigenschaften

amText : string

Der lokalisierte Name des Suffixes „AM“ für Uhrzeiten, die nach den Konventionen der 12-Stunden-Uhr angegeben werden.

decimalPoint : string

Enthält das Dezimalpunktzeichen dieser Locale.

exponential : string

Speichert den exponentiellen Charakter dieser Locale.

firstDayOfWeek : enumeration

Gibt den ersten Tag der Woche gemäß der aktuellen Ländereinstellung zurück.

groupSeparator : string

Enthält das Trennzeichen für Gruppen dieser Locale.

measurementSystem : enumeration

Diese Eigenschaft legt fest, welche Einheiten für die Messung verwendet werden.

name : string

Speichert die Sprache und das Gebiet dieser Ländereinstellung als Zeichenfolge der Form „Sprache_Gebiet“, wobei „Sprache“ ein zweistelliger ISO-639-Sprachcode in Kleinbuchstaben und „Gebiet“ ein zwei- oder dreistelliger ISO-3166-Gebietscode in Großbuchstaben ist.

nativeLanguageName : string

Enthält einen einheimischen Namen der Sprache für die Ländereinstellung. Zum Beispiel „Schwiizertüütsch“ für die Ländereinstellung „Schweizerdeutsch“.

Siehe auch nativeTerritoryName.

nativeTerritoryName : string

Enthält einen einheimischen Namen des Gebiets für die Sprachumgebung. Zum Beispiel „España“ für die Sprachumgebung „Spanisch/Spanien“.

Siehe auch nativeLanguageName.

negativeSign : string

Enthält das Minuszeichen dieser Locale.

numberOptions : enumeration

Enthält eine Reihe von Optionen für die Konvertierung von Zahlen in Zeichenketten und von Zeichenketten in Zahlen.

Siehe auch string Number::toLocaleString(locale, format, precision) und string Number::fromLocaleString(locale, number).

percent : string

Enthält das Prozentzeichen dieser Locale.

pmText : string

Der lokalisierte Name des Suffixes „PM“ für Zeiten, die nach den Konventionen der 12-Stunden-Uhr angegeben werden.

positiveSign : string

Enthält das Vorzeichen dieses Locales.

textDirection : enumeration

Enthält die Textrichtung der Sprache:

uiLanguages : Array<string>

Gibt eine sortierte Liste von Sprachumgebungsnamen für Übersetzungszwecke in der Reihenfolge der Präferenz zurück.

Der Rückgabewert enthält die Sprachumgebungsnamen, in denen der Benutzer die Übersetzung der Benutzeroberfläche erwartet.

Das erste Element in der Liste ist das am meisten bevorzugte.

weekDays : Array<int>

Enthält ein Array mit Tagen, die gemäß der aktuellen Ländereinstellung als Wochentage gelten, wobei Sonntag den Wert 0 und Samstag den Wert 6 hat.

Siehe auch firstDayOfWeek.

zeroDigit : string

Holds Gibt das Zeichen für die Ziffer „0“ dieser Locale zurück.

Methodendokumentation

[since 6.10] string createSeparatedList(list<string> list)

Gibt eine Zeichenkette zurück, die eine Verknüpfung einer vorgegebenen Zeichenkette „ list “ mit einem durch die Locale definierten Trennzeichen darstellt.

Diese Methode wurde in Qt 6.10 eingeführt.

Siehe auch ` QLocale::createSeparatedList()`.

string currencySymbol(format)

Gibt das Währungssymbol für den angegebenen Wert „ format “ zurück:

Siehe auch die Zeichenkette`Number::toLocaleCurrencyString(locale, symbol)`.

string dateFormat(type)

Gibt das für die aktuelle Ländereinstellung verwendete Datumsformat zurück. Mit ` type ` wird das zurückzugebende ` FormatType ` festgelegt.

Siehe auch Das JavaScript-Objekt „Date“.

string dateTimeFormat(type)

Gibt das für die aktuelle Ländereinstellung verwendete Datums- und Zeitformat zurück. Mit „ type “ wird das zurückzugebende Datums- und Zeitformat „ FormatType “ festgelegt.

Siehe auch Das JavaScript-Objekt „Date“.

string dayName(day, type)

Gibt den lokalisierten Namen des „ day “ zurück (wobei 0 für Sonntag, 1 für Montag usw. steht), und zwar in der optionalen Form „ FormatType “, die durch „ type “ festgelegt wird.

Siehe auch „ monthName()“ und „ standaloneDayName()“.

[since 6.2] string formattedDataSize(int bytes, int precision, DataSizeFormat format)

Konvertiert eine Größe in „ bytes “ in eine für Menschen lesbare, lokalisierte Zeichenfolge, bestehend aus einer Zahl und einer quantifizierten Einheit.

Die Argumente „ precision “ und „ format “ sind optional.

Weitere Informationen finden Sie unter „ QLocale::formattedDataSize()“.

Diese Methode wurde in Qt 6.2 eingeführt.

Siehe auch „ QLocale::DataSizeFormats “.

string monthName(month, type)

Gibt den lokalisierten Namen von „ month “ (0–11) in der optionalen Form „ FormatType “ zurück, die durch „ type “ festgelegt wird.

Siehe auch dayName() und standaloneMonthName().

string standaloneDayName(day, type)

Gibt den lokalisierten Namen des „ day “ zurück (wobei 0 für Sonntag, 1 für Montag usw. steht), der als eigenständiger Text in der durch „ type “ angegebenen „ FormatType “ verwendet wird.

Wenn die Lokalisierungsinformationen keinen eigenständigen Tagesnamen angeben, entspricht der Rückgabewert dem von ` dayName()`.

Siehe auch dayName() und standaloneMonthName().

string standaloneMonthName(month, type)

Gibt den lokalisierten Namen von „ month “ (0–11) zurück, der als eigenständiger Text in der optionalen „ FormatType “ verwendet wird, die durch „ type “ festgelegt ist.

Wenn die Locale-Informationen keinen eigenständigen Monatsnamen angeben, entspricht der Rückgabewert dem von ` monthName()`.

Siehe auch monthName() und standaloneDayName().

string timeFormat(type)

Gibt das für die aktuelle Ländereinstellung verwendete Zeitformat zurück. Mit ` type ` wird das zurückzugebende ` FormatType ` festgelegt.

Siehe auch Das JavaScript-Objekt „Date“.

[since 6.5] string toString(int i)

Gibt eine lokalisierte Zeichenkettendarstellung von ` i` zurück.

Diese Methode wurde in Qt 6.5 eingeführt.

Siehe auch „ QLocale::toString“ (int).

[since 6.5] string toString(Date date, FormatType format = LongFormat)

Gibt eine lokalisierte Zeichenfolgendarstellung des angegebenen „ date “ in der angegebenen „ format “ zurück. Wird „ format “ weggelassen, wird „ Locale.LongFormat “ verwendet.

Diese Methode wurde in Qt 6.5 eingeführt.

Siehe auch ` QLocale::toString` (QDate, QLocale::FormatType).

[since 6.5] string toString(Date date, string format)

Gibt eine lokalisierte Zeichenfolgendarstellung des angegebenen „ date “ in der angegebenen „ format “ zurück. Ist „ format “ eine leere Zeichenfolge, wird eine leere Zeichenfolge zurückgegeben.

Diese Methode wurde in Qt 6.5 eingeführt.

Siehe auch ` QLocale::toString` (QDate, QStringView).

[since 6.5] string toString(double f, char format = 'g', int precision = 6)

Gibt eine Zeichenkette zurück, die die Gleitkommazahl f darstellt.

Die Form der Darstellung wird durch die optionalen Parameter ` format ` und ` precision ` gesteuert.

Weitere Informationen finden Sie unter „ QLocale::toString(double, char, int)“.

Diese Methode wurde in Qt 6.5 eingeführt.