Locale QML Type

Stellt regionalspezifische Eigenschaften und formatierte Daten zur Verfügung. Mehr...

Import Statement: import QtQml

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 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)

Detaillierte Beschreibung

Das Locale-Objekt kann 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 das Gebietsschema mit dem angegebenen Namen darstellt, der das Format "language[_territory][.codeset][@modifier]" oder "C" hat.

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

Das Locale-Objekt bietet eine Reihe von Funktionen und Eigenschaften, die Daten für die angegebene Locale bereitstellen.

Das Locale-Objekt kann auch an die Methoden Date und Number toLocaleString() und fromLocaleString() übergeben werden, um Strings unter Verwendung der angegebenen Locale zu konvertieren.

In diesem Beispiel wird das aktuelle Datum im deutschen Gebietsschema formatiert:

import QtQuick 2.0

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

Das folgende Beispiel zeigt die angegebene Zahl im richtigen Format für das Standardgebietsschema an:

import QtQuick 2.0

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

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

Locale String Format Typen

Die Funktionen monthName(), standaloneMonthName(), dayName() und standaloneDayName() können die folgenden Aufzählungswerte verwenden, um die Formatierung der String-Darstellung für ein Datumsobjekt anzugeben.

Konstante	Beschreibung
`Locale.LongFormat`	Die lange Version von Tages- und Monatsnamen, z. B. die Rückgabe von "Januar" als Monatsname.
`Locale.ShortFormat`	Die Kurzversion von Tages- und Monatsnamen, z. B. die Rückgabe von "Jan" als Monatsname.
`Locale.NarrowFormat`	Eine spezielle Version von Tages- und Monatsnamen, die verwendet werden kann, wenn der Platz begrenzt ist, z. B. die Rückgabe von "J" als Monatsname. Beachten Sie, dass das schmale Format den gleichen Text für verschiedene Monate und Tage enthalten kann oder sogar eine leere Zeichenkette sein kann, wenn das Gebietsschema keine schmalen Namen unterstützt, so dass Sie es nicht für die Datumsformatierung verwenden sollten. Außerdem ist dieses Format für das Systemgebietsschema das gleiche wie ShortFormat.

Zusätzlich sind die Funktionen zur Umwandlung von Double in String und String in Double durch die folgenden Lizenzen abgedeckt:

Es wird hiermit die Erlaubnis erteilt, diese Software für beliebige Zwecke zu verwenden, zu kopieren, zu modifizieren und zu vertreiben, vorausgesetzt, dass dieser gesamte Hinweis in allen Kopien jeglicher Software, die eine Kopie oder Modifikation dieser Software ist oder enthält, und in allen Kopien der unterstützenden Dokumentation für diese Software enthalten ist.

DIESE SOFTWARE WIRD OHNE MÄNGELGEWÄHR UND OHNE JEGLICHE AUSDRÜCKLICHE ODER STILLSCHWEIGENDE GARANTIE ZUR VERFÜGUNG GESTELLT. INSBESONDERE GEBEN WEDER DER AUTOR NOCH AT&T IRGENDEINE ZUSICHERUNG ODER GARANTIE BEZÜGLICH DER MARKTGÄNGIGKEIT DIESER SOFTWARE ODER IHRER EIGNUNG FÜR EINEN BESTIMMTEN ZWECK.

Dieses Produkt enthält Software, die von der University of California, Berkeley und ihren Mitarbeitern entwickelt wurde.

Siehe auch Date und Number.

Eigentum Dokumentation

amText : string

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

decimalPoint : string

Enthält das Dezimalpunktzeichen dieses Gebietsschemas.

exponential : string

Enthält das Exponentialzeichen dieses Gebietsschemas.

firstDayOfWeek : enumeration

Enthält den ersten Tag der Woche gemäß dem aktuellen Gebietsschema.

Konstante	Beschreibung
`Locale.Sunday`	0
`Locale.Monday`	1
`Locale.Tuesday`	2
`Locale.Wednesday`	3
`Locale.Thursday`	4
`Locale.Friday`	5
`Locale.Saturday`	6

Hinweis: Diese Werte entsprechen der JS Date API, die sich von der Qt C++ API unterscheidet, wo Qt::Sunday = 7 ist.

groupSeparator : string

Enthält das Gruppentrennzeichen dieses Gebietsschemas.

measurementSystem : enumeration

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

Konstante	Beschreibung
`Locale.MetricSystem`	Dieser Wert gibt metrische Einheiten an, wie Meter, Zentimeter und Millimeter.
`Locale.ImperialUSSystem`	Dieser Wert gibt imperiale Einheiten an, z. B. Zoll und Meilen, wie sie in den Vereinigten Staaten verwendet werden.
`Locale.ImperialUKSystem`	Dieser Wert gibt imperiale Einheiten an, wie z. B. Zoll und Meilen, wie sie im Vereinigten Königreich verwendet werden.
`Locale.ImperialSystem`	Wird aus Kompatibilitätsgründen bereitgestellt. Dasselbe wie Locale.ImperialUSSystem.

name : string

Enthält die Sprache und das Gebiet dieses Gebietsschemas als Zeichenkette der Form "language_territory", wobei language ein kleingeschriebener, zweibuchstabiger ISO-639-Sprachcode und territory ein großgeschriebener, zwei- oder dreibuchstabiger ISO-3166-Gebietscode ist.

nativeLanguageName : string

Enthält einen einheimischen Namen der Sprache für das Gebietsschema. Zum Beispiel "Schwiizertüütsch" für Schweizerdeutsches Gebietsschema.

Siehe auch nativeTerritoryName.

nativeTerritoryName : string

Enthält einen einheimischen Namen des Gebiets für das Gebietsschema. Zum Beispiel "España" für das Gebietsschema Spanisch/Spanien.

Siehe auch nativeLanguageName.

negativeSign : string

Enthält das negative Vorzeichen für dieses Gebietsschema.

numberOptions : enumeration

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

Siehe auch Number::toLocaleString() und Number::fromLocaleString().

percent : string

Enthält das Prozentzeichen dieses Gebietsschemas.

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 positive Vorzeichen dieses Gebietsschemas.

textDirection : enumeration

Enthält die Textrichtung der Sprache:

Konstante	Beschreibung
`Qt.LeftToRight`	Text beginnt normalerweise auf der linken Seite.
`Qt.RightToLeft`	Text beginnt normalerweise auf der rechten Seite.

uiLanguages : Array<string>

Gibt eine geordnete Liste von Gebietsschema-Namen für Übersetzungszwecke in Vorzugsreihenfolge zurück.

Der Rückgabewert stellt die Namen der Gebietsschemata dar, in denen der Benutzer die Übersetzung der Benutzeroberfläche zu sehen erwartet.

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

weekDays : Array<int>

Enthält ein Array von Tagen, die nach dem aktuellen Gebietsschema als Wochentage gelten, wobei Sonntag 0 und Samstag 6 ist.

Siehe auch firstDayOfWeek.

zeroDigit : string

Enthält das Nullziffernzeichen dieses Gebietsschemas.

Dokumentation der Methode

string currencySymbol(format)

Gibt das Währungssymbol für das angegebene format zurück:

Konstante	Beschreibung
`Locale.CurrencyIsoCode`	ein ISO-4217-Code der Währung.
`Locale.CurrencySymbol`	ein Währungssymbol.
`Locale.CurrencyDisplayName`	ein vom Benutzer lesbarer Name der Währung.

Siehe auch Number::toLocaleCurrencyString().

string dateFormat(type)

Gibt das für das aktuelle Gebietsschema verwendete Datumsformat zurück. type gibt das zurückzugebende FormatType an.

Siehe auch Date.

string dateTimeFormat(type)

Gibt das für das aktuelle Gebietsschema verwendete Datums- und Zeitformat zurück. type gibt das FormatType an, das zurückgegeben werden soll.

Siehe auch Date.

string dayName(day, type)

Gibt den lokalisierten Namen des day zurück (wobei 0 für Sonntag, 1 für Montag usw. steht), in der optionalen FormatType, die durch type angegeben 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 menschenlesbare lokalisierte Zeichenkette, die eine Zahl und eine quantifizierte Einheit enthält.

Die Argumente precision und format sind optional.

Für weitere Informationen, siehe 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) zurück, in der optionalen FormatType, die durch type angegeben wird.

Hinweis: Die QLocale C++ API erwartet einen Bereich von (1-12), jedoch erwartet Locale.monthName() 0-11, wie im JS Date Objekt.

Siehe auch dayName() und standaloneMonthName().

string standaloneDayName(day, type)

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

Wenn die Gebietsschema-Informationen den Namen des eigenständigen Tages nicht angeben, ist der Rückgabewert derselbe wie in 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 dem optionalen FormatType verwendet wird, der durch type angegeben wird.

Wenn die Gebietsschema-Informationen den eigenständigen Monatsnamen nicht angeben, ist der Rückgabewert derselbe wie in monthName().

Hinweis: Die C++-API QLocale erwartet einen Bereich von (1-12), Locale.standaloneMonthName() erwartet jedoch 0-11 wie im JS-Date-Objekt.

Siehe auch monthName() und standaloneDayName().

string timeFormat(type)

Gibt das für das aktuelle Gebietsschema verwendete Zeitformat zurück. type gibt das FormatType an, das zurückgegeben werden soll.

Siehe auch Date.

[since 6.5] string toString(int i)

Gibt eine lokalisierte String-Repräsentation 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)

Dies ist eine überladene Funktion.

Gibt eine lokalisierte Zeichenkettendarstellung der angegebenen date in der angegebenen format zurück. Wenn format weggelassen wird, 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)

Dies ist eine überladene Funktion.

Gibt eine lokalisierte Zeichenkettendarstellung der angegebenen date in der angegebenen format zurück. Wenn format ein leerer String ist, wird ein leerer String 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)

Dies ist eine überladene Funktion.

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

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

Siehe QLocale::toString(double, char, int) für weitere Informationen.

Diese Methode wurde in Qt 6.5 eingeführt.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.