Locale QML Type

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

Import Statement: import QtQml

Propriétés

Méthodes

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.

ConstanteDescription
Locale.LongFormatLa version longue des noms de jour et de mois ; par exemple, "janvier" comme nom de mois.
Locale.ShortFormatLa version courte des noms de jour et de mois ; par exemple, "Jan" comme nom de mois.
Locale.NarrowFormatUne version spéciale des noms de jour et de mois à utiliser lorsque l'espace est limité ; par exemple, en renvoyant "J" comme nom de mois. Notez que le format étroit peut contenir le même texte pour différents mois et jours ou peut même être une chaîne vide si la locale ne prend pas en charge les noms étroits, vous devez donc éviter de l'utiliser pour le formatage de la date. De plus, pour la locale du système, ce format est le même que ShortFormat.

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

Copyright (c) 1991 by AT&T.

L'autorisation d'utiliser, de copier, de modifier et de distribuer ce logiciel dans n'importe quel but et sans frais est accordée par la présente, à condition que cet avis soit inclus dans toutes les copies de tout logiciel qui est ou inclut une copie ou une modification de ce logiciel et dans toutes les copies de la documentation d'appui de ce logiciel.

CE LOGICIEL EST FOURNI "TEL QUEL", SANS AUCUNE GARANTIE EXPRESSE OU IMPLICITE. EN PARTICULIER, NI L'AUTEUR NI AT&T NE FONT DE DÉCLARATION OU NE DONNENT DE GARANTIE DE QUELQUE NATURE QUE CE SOIT CONCERNANT LA QUALITÉ MARCHANDE DE CE LOGICIEL OU SON ADÉQUATION À UN USAGE PARTICULIER.

Ce produit comprend des logiciels développés par l'Université de Californie, Berkeley et ses contributeurs.

Voir également Date et Number.

Documentation sur la propriété

amText : string

Le nom localisé du suffixe "AM" pour les heures spécifiées en utilisant les conventions de l'horloge de 12 heures.


decimalPoint : string

Contient le caractère décimal de cette locale.


exponential : string

Contient le caractère exponentiel de cette locale.


firstDayOfWeek : enumeration

Indique le premier jour de la semaine selon la locale actuelle.

ConstanteDescription de la constante
Locale.Sunday0
Locale.Monday1
Locale.Tuesday2
Locale.Wednesday3
Locale.Thursday4
Locale.Friday5
Locale.Saturday6

Remarque : ces valeurs correspondent à l'API JS Date qui est différente de l'API Qt C++ où Qt::Sunday = 7.


groupSeparator : string

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


measurementSystem : enumeration

Cette propriété définit les unités de mesure utilisées.

ConstanteDescription
Locale.MetricSystemCette valeur indique les unités métriques, telles que les mètres, les centimètres et les millimètres.
Locale.ImperialUSSystemCette valeur indique les unités impériales, telles que les pouces et les miles utilisés aux États-Unis.
Locale.ImperialUKSystemCette valeur indique les unités impériales, telles que les pouces et les miles utilisés au Royaume-Uni.
Locale.ImperialSystemFourni à des fins de compatibilité. Identique à Locale.ImperialUSSystem.

name : string

Détient 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 ISO 639 en minuscules, à deux lettres, et territoire est un code de territoire ISO 3166 en majuscules, à deux ou trois lettres.


nativeLanguageName : string

Contient un nom natif de la langue pour la localité. Par exemple, "Schwiizertüütsch" pour la région suisse-allemande.

Voir aussi nativeTerritoryName.


nativeTerritoryName : string

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

Voir également nativeLanguageName.


negativeSign : string

Contient le signe négatif de cette locale.


numberOptions : enumeration

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

Voir également Number::toLocaleString() et Number::fromLocaleString().


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 :

ConstanteDescription
Qt.LeftToRightLe texte commence normalement à gauche.
Qt.RightToLeftLe texte commence normalement à droite.

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ù le dimanche vaut 0 et le samedi vaut 6.

Voir aussi firstDayOfWeek.


zeroDigit : string

Holds Renvoie le chiffre 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 le format spécifié :

ConstanteDescription
Locale.CurrencyIsoCodeun code ISO-4217 de la devise.
Locale.CurrencySymbolun symbole de la devise.
Locale.CurrencyDisplayNameun nom de devise lisible par l'utilisateur.

Voir également Number::toLocaleCurrencyString().


string dateFormat(type)

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

Voir aussi Date.


string dateTimeFormat(type)

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

Voir aussi 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.

Remarque : l'API C++ de QLocale s'attend à une plage de (1-12), alors que Locale.monthName() s'attend à 0-11, conformément à l'objet JS Date.

Voir aussi dayName() et standaloneMonthName().


string standaloneDayName(day, type)

Renvoie le nom localisé de day (où 0 représente le dimanche, 1 le lundi et ainsi de suite) qui est utilisé comme texte autonome, dans le 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é comme 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 de retour est la même que pour monthName().

Remarque : l'API C++ de QLocale s'attend à une plage de (1-12), alors que Locale.standaloneMonthName() s'attend à 0-11, conformément à l'objet JS Date.

Voir aussi monthName() et standaloneDayName().


string timeFormat(type)

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

Voir aussi 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é.

Il s'agit d'une fonction surchargée.

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.

Il s'agit d'une fonction surchargé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.

Il s'agit d'une fonction surchargée.

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


© 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.