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
- 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.
| Constante | Description |
|---|---|
Locale.LongFormat | La version longue des noms de jour et de mois ; par exemple, "janvier" comme nom de mois. |
Locale.ShortFormat | La version courte des noms de jour et de mois ; par exemple, "Jan" comme nom de mois. |
Locale.NarrowFormat | Une 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.
| Constante | Description de la constante |
|---|---|
Locale.Sunday | 0 |
Locale.Monday | 1 |
Locale.Tuesday | 2 |
Locale.Wednesday | 3 |
Locale.Thursday | 4 |
Locale.Friday | 5 |
Locale.Saturday | 6 |
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.
| Constante | Description |
|---|---|
Locale.MetricSystem | Cette valeur indique les unités métriques, telles que les mètres, les centimètres et les millimètres. |
Locale.ImperialUSSystem | Cette valeur indique les unités impériales, telles que les pouces et les miles utilisés aux États-Unis. |
Locale.ImperialUKSystem | Cette valeur indique les unités impériales, telles que les pouces et les miles utilisés au Royaume-Uni. |
Locale.ImperialSystem | Fourni à 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 :
| Constante | Description |
|---|---|
Qt.LeftToRight | Le texte commence normalement à gauche. |
Qt.RightToLeft | Le 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
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é :
| Constante | Description |
|---|---|
Locale.CurrencyIsoCode | un code ISO-4217 de la devise. |
Locale.CurrencySymbol | un symbole de la devise. |
Locale.CurrencyDisplayName | un 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().
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.
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).
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).
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).
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.