Locale QML Type

Fournit des propriétés spécifiques à la locale et des données formatées. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités
• Les membres obsolètes

Propriétés

• 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

Méthodes

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

Description détaillée

L'objet Locale ne peut être créé que via la fonction Qt.locale(). Il ne peut pas être créé directement.

La fonction Qt.locale() renvoie un objet JS Locale représentant la locale avec le nom spécifié, qui a le format "language[_territory][.codeset][@modifier]" ou "C".

Locale prend en charge le concept de locale par défaut, qui est déterminé à partir des paramètres de locale du système au démarrage de l'application. Si aucun paramètre n'est passé à Qt.locale(), l'objet locale par défaut est renvoyé.

L'objet Locale fournit un certain nombre de fonctions et de propriétés fournissant des données pour la locale spécifiée.

L'objet Locale peut également être transmis aux méthodes Date et Number toLocaleString() et fromLocaleString() afin de convertir des chaînes de caractères en utilisant la locale spécifiée.

Cet exemple montre la date actuelle formatée pour la locale allemande :

import QtQuick 2.0

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

L'exemple suivant affiche le nombre spécifié dans le format correct de la locale par défaut :

import QtQuick 2.0

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

Qt Quick Les données de la locale sont basées sur le Common Locale Data Repository v1.8.1.

Types de format de chaîne de caractères Locale

Les fonctions monthName(), standaloneMonthName(), dayName() et standaloneDayName() peuvent utiliser les valeurs d'énumération suivantes pour spécifier le formatage de la représentation de la chaîne de caractères d'un objet Date.

En outre, les fonctions de conversion double-chaîne et chaîne-deux sont couvertes par les licences suivantes :

Voir aussi l'objet JavaScript Date et l'objet JavaScript Number.

Documentation sur les propriétés

amText : string

Nom localisé du suffixe "AM" pour les heures spécifiées selon les conventions de l'horloge de 12 heures.

decimalPoint : string

Contient le caractère de la virgule décimale de cette locale.

exponential : string

Contient le caractère exponentiel de cette locale.

firstDayOfWeek : enumeration

Indique le premier jour de la semaine en fonction du lieu de résidence actuel.

groupSeparator : string

Contient le caractère séparateur de groupe de cette locale.

measurementSystem : enumeration

Cette propriété définit les unités utilisées pour les mesures.

name : string

Contient la langue et le territoire de cette locale sous la forme d'une chaîne de la forme "langue_territoire", où langue est un code de langue minuscule à deux lettres de la norme ISO 639, et territoire est un code de territoire majuscule à deux ou trois lettres de la norme ISO 3166.

nativeLanguageName : string

Contient un nom natif de la langue pour les paramètres régionaux. Par exemple, "Schwiizertüütsch" pour les paramètres régionaux suisses-allemands.

Voir aussi nativeTerritoryName.

nativeTerritoryName : string

Contient un nom natif du territoire pour la région. Par exemple, "España" pour les paramètres régionaux espagnols.

Voir également nativeLanguageName.

negativeSign : string

Contient le caractère de signe négatif de cette locale.

numberOptions : enumeration

Contient un ensemble d'options pour les conversions nombre-chaîne et chaîne-nombre.

Voir aussi string Number::toLocaleString(locale, format, précision) et string Number::fromLocaleString(locale, nombre).

percent : string

Contient le caractère pour cent de cette locale.

pmText : string

Nom localisé du suffixe "PM" pour les heures spécifiées selon les conventions de l'horloge de 12 heures.

positiveSign : string

Contient le caractère de signe positif de cette locale.

textDirection : enumeration

Détient le sens du texte de la langue :

uiLanguages : Array<string>

Renvoie une liste ordonnée de noms de paramètres linguistiques à des fins de traduction, dans l'ordre des préférences.

La valeur renvoyée représente les noms de paramètres linguistiques dans lesquels l'utilisateur s'attend à voir la traduction de l'interface utilisateur.

Le premier élément de la liste est celui qui est le plus préféré.

weekDays : Array<int>

Contient un tableau de jours qui sont considérés comme des jours de semaine selon la locale actuelle, où dimanche vaut 0 et samedi vaut 6.

Voir aussi firstDayOfWeek.

zeroDigit : string

Tient Renvoie le caractère zéro de cette locale.

Documentation de la méthode

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

Renvoie une chaîne qui représente une jointure d'une list donnée de chaînes avec un séparateur défini par la locale.

Cette méthode a été introduite dans Qt 6.10.

Voir aussi QLocale::createSeparatedList().

string currencySymbol(format)

Renvoie le symbole de la devise pour la valeur spécifiée format:

Voir aussi la chaîne Number::toLocaleCurrencyString(locale, symbol).

string dateFormat(type)

Renvoie le format de date utilisé pour la locale actuelle. type spécifie le FormatType à renvoyer.

Voir aussi l'objet JavaScript Date.

string dateTimeFormat(type)

Renvoie le format de date et d'heure utilisé pour la locale actuelle. type spécifie le FormatType à renvoyer.

Voir aussi l'objet JavaScript Date.

string dayName(day, type)

Renvoie le nom localisé de day (où 0 représente le dimanche, 1 le lundi et ainsi de suite), dans l'option FormatType spécifiée par type.

Voir aussi monthName() et standaloneDayName().

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

Convertit une taille en bytes en une chaîne localisée lisible par l'homme, comprenant un nombre et une unité quantifiée.

Les arguments precision et format sont facultatifs.

Pour plus d'informations, voir QLocale::formattedDataSize().

Cette méthode a été introduite dans Qt 6.2.

Voir aussi QLocale::DataSizeFormats.

string monthName(month, type)

Renvoie le nom localisé de month (0-11), dans l'option FormatType spécifiée par type.

Voir aussi dayName() et standaloneMonthName().

string standaloneDayName(day, type)

Renvoie le nom localisé du jour day (où 0 représente le dimanche, 1 le lundi et ainsi de suite) qui est utilisé comme texte autonome dans le site FormatType spécifié par type.

Si les informations locales ne précisent pas le nom du jour autonome, la valeur renvoyée est la même que dans dayName().

Voir aussi dayName() et standaloneMonthName().

string standaloneMonthName(month, type)

Renvoie le nom localisé de month (0-11) qui est utilisé en tant que texte autonome, dans l'option FormatType spécifiée par type.

Si les informations locales ne spécifient pas le nom du mois autonome, la valeur retournée est la même que dans monthName().

Voir aussi monthName() et standaloneDayName().

string timeFormat(type)

Renvoie le format de l'heure utilisé pour la locale actuelle. type spécifie le FormatType à renvoyer.

Voir aussi l'objet JavaScript Date.

[since 6.5] string toString(int i)

Renvoie une représentation sous forme de chaîne de caractères localisée de i.

Cette méthode a été introduite dans Qt 6.5.

Voir aussi QLocale::toString(int).

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

Renvoie une représentation sous forme de chaîne localisée de l'adresse date donnée dans l'adresse format spécifiée. Si format est omis, Locale.LongFormat est utilisé.

Cette méthode a été introduite dans Qt 6.5.

Voir aussi QLocale::toString(QDate, QLocale::FormatType).

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

Renvoie une représentation sous forme de chaîne localisée de l'adresse date donnée dans l'adresse format spécifiée. Si format est une chaîne vide, une chaîne vide est renvoyée.

Cette méthode a été introduite dans Qt 6.5.

Voir aussi QLocale::toString(QDate, QStringView).

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

Renvoie une chaîne de caractères représentant le nombre à virgule flottante f.

La forme de la représentation est contrôlée par les paramètres optionnels format et precision.

Voir QLocale::toString(double, char, int) pour plus d'informations.

Cette méthode a été introduite dans Qt 6.5.