Locale QML Type

Fournit des propriétés spécifiques à la locale et des données mises en forme. En savoir plus…

• Liste de tous les membres, y compris les membres hérités
• 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éé qu'à l'aide de la fonction Qt.locale(). Il ne peut pas être créé directement.

La fonction Qt.locale() renvoie un objet JS Locale représentant la locale dont le nom est spécifié, qui a le format « langue[_territoire][.jeu de caractères][@modificateur] » ou « C ».

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

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

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

Cet exemple montre la date du jour formatée selon les paramètres régionaux allemands :

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 pour les paramètres régionaux par défaut :

import QtQuick 2.0

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

Qt Quick Les données de paramètres régionaux sont basées sur le Common Locale Data Repository v1.8.1.

Types de format de chaîne de la locale

Les méthodes ` monthName()`, ` standaloneMonthName()`, ` dayName()` et ` standaloneDayName()` peuvent utiliser les valeurs d'énumération suivantes pour spécifier le formatage de la représentation sous forme de chaîne d'un objet `Date`.

Par ailleurs, les fonctions de conversion « double vers chaîne » et « chaîne vers double » sont couvertes par les licences suivantes :

Voir également 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 exprimées selon le format de 12 heures.

decimalPoint : string

Contient le caractère représentant la virgule décimale dans cette locale.

exponential : string

Contient le caractère exponentiel de cette configuration régionale.

firstDayOfWeek : enumeration

Renvoie le premier jour de la semaine selon les paramètres régionaux actuels.

groupSeparator : string

Contient le caractère de séparation des groupes de cette locale.

measurementSystem : enumeration

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

name : string

Stocke la langue et le territoire de cette configuration régionale sous la forme d'une chaîne de caractères « langue_territoire », où « langue » correspond à un code de langue ISO 639 à deux lettres en minuscules, et « territoire » à un code de territoire ISO 3166 à deux ou trois lettres en majuscules.

nativeLanguageName : string

Contient le nom en langue locale correspondant à la locale. Par exemple, « Schwiizertüütsch » pour la locale « suisse-allemand ».

Voir aussi nativeTerritoryName.

nativeTerritoryName : string

Contient le nom local du territoire correspondant à la configuration régionale. Par exemple, « España » pour la configuration régionale « Espagnol/Espagne ».

Voir également nativeLanguageName.

negativeSign : string

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

numberOptions : enumeration

Contient un ensemble d'options pour les conversions de nombres en chaînes de caractères et de chaînes de caractères en nombres.

Voir également string Number::toLocaleString(locale, format, precision) et string Number::fromLocaleString(locale, number).

percent : string

Contient le caractère de pourcentage de cette locale.

pmText : string

Nom localisé du suffixe « PM » pour les heures exprimées selon le format de 12 heures.

positiveSign : string

Contient le caractère représentant le signe positif de cette locale.

textDirection : enumeration

Contient le sens d'écriture de la langue :

uiLanguages : Array<string>

Renvoie une liste triée des noms de paramètres régionaux à des fins de traduction, classés par ordre de préférence.

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

Le premier élément de la liste est celui qui a la priorité la plus élevée.

weekDays : Array<int>

Contient un tableau de jours considérés comme des jours de la semaine selon les paramètres régionaux actuels, où le dimanche correspond à 0 et le samedi à 6.

Voir également firstDayOfWeek.

zeroDigit : string

Holds Renvoie le caractère représentant le chiffre zéro dans cette locale.

Documentation de la méthode

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

Renvoie une chaîne de caractères représentant la concaténation d'une « list » donnée de chaînes de caractères, séparées par un séparateur défini par les paramètres régionaux.

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

Voir aussi QLocale::createSeparatedList().

string currencySymbol(format)

Renvoie le symbole monétaire correspondant à l'format spécifiée :

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

string dateFormat(type)

Renvoie le format de date utilisé pour les paramètres régionaux actuels. La méthode ` type ` permet de spécifier l'FormatType s à renvoyer.

Voir aussi L'objet JavaScript Date.

string dateTimeFormat(type)

Renvoie le format de date et d'heure utilisé pour les paramètres régionaux actuels. La propriété ` type ` spécifie l'FormatType s à renvoyer.

Voir aussi L'objet JavaScript Date.

string dayName(day, type)

Renvoie le nom localisé de l’ day (où 0 correspond au dimanche, 1 au lundi, et ainsi de suite), dans la FormatType facultative spécifiée par type.

Voir également monthName() et standaloneDayName().

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

Convertit une taille exprimée en « bytes » en une chaîne localisée lisible par l'utilisateur, composée d'un nombre et d'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 également QLocale::DataSizeFormats.

string monthName(month, type)

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

Voir également dayName() et standaloneMonthName().

string standaloneDayName(day, type)

Renvoie le nom localisé du « day » (où 0 correspond au dimanche, 1 au lundi, et ainsi de suite) utilisé comme texte autonome, dans les paramètres de localisation ( FormatType ) spécifiés par ` type`.

Si les informations de localisation ne spécifient pas le nom du jour utilisé seul, la valeur renvoyée est alors la même que celle de la fonction dayName().

Voir également dayName() et standaloneMonthName().

string standaloneMonthName(month, type)

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

Si les informations de locale ne précisent pas le nom du mois utilisé seul, la valeur renvoyée est alors la même que celle de la fonction ` monthName()` ().

Voir également monthName() et standaloneDayName().

string timeFormat(type)

Renvoie le format d'heure utilisé pour les paramètres régionaux actuels. La méthode ` type ` permet de spécifier l'FormatType s à renvoyer.

Voir aussi L'objet JavaScript Date.

[since 6.5] string toString(int i)

Renvoie une représentation sous forme de chaîne localisée de ` i`.

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

Voir également 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'date donné dans l'format spécifié. Si format est omis, Locale.LongFormat est utilisé.

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

Voir également 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'date on fournie dans l'format on 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 cette représentation est contrôlée par les paramètres facultatifs format et precision.

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

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