QLocale Class

Documentation des fonctions membres

QLocale::QLocale()

Construit un objet QLocale initialisé avec la locale par défaut.

Si aucune locale par défaut n'a été définie à l'aide de setDefault(), cette locale sera la même que celle renvoyée par system().

Voir aussi setDefault() et system().

[explicit, since 6.3] QLocale::QLocale(QStringView name)

Construit un objet QLocale avec le nom spécifié name.

Le nom a le format "language[_script][_territory][.codeset][@modifier]" ou "C", où :

• langue est un code de langue ISO 639 à deux lettres minuscules (certains codes à trois lettres sont également reconnus),
• script est un code de script en majuscules, à quatre lettres, de la norme ISO 15924,
• territoire est un code de territoire en majuscules, à deux lettres, de la norme ISO 3166 (certains codes numériques sont également reconnus), et
• le jeu de codes et le modificateur sont ignorés.

Le séparateur peut être soit un trait de soulignement '_' (U+005F, "low line"), soit un tiret '-' (U+002D, "hyphen-minus"). Si QLocale n'a pas de données pour la combinaison spécifiée de langue, d'écriture et de territoire, il utilise la correspondance la plus appropriée qu'il peut trouver à la place. Si la chaîne ne respecte pas le format de la locale, ou si aucune donnée appropriée ne peut être trouvée pour les clés spécifiées, la locale "C" est utilisée à la place.

Ce constructeur est beaucoup plus lent que QLocale(Language, Script, Territory) ou QLocale(Language, Territory).

Cette fonction a été introduite dans Qt 6.3.

Voir aussi bcp47Name() et Matching combinations of language, script and territory.

QLocale::QLocale(QLocale::Language language, QLocale::Territory territory)

Construit un objet QLocale pour les language et territory spécifiés.

Si plusieurs scripts sont utilisés pour cette combinaison, le script le plus probable sera sélectionné. Si QLocale n'a pas de données pour le site language, la locale par défaut est utilisée. Si QLocale n'a pas de données pour la combinaison spécifiée de language et territory, un autre territoire peut être utilisé à la place.

Voir aussi setDefault() et Matching combinations of language, script and territory.

QLocale::QLocale(QLocale::Language language, QLocale::Script script = AnyScript, QLocale::Territory territory = AnyTerritory)

Construit un objet QLocale pour les combinaisons spécifiées language, script et territory.

Si QLocale ne dispose pas de données pour la combinaison donnée, il trouvera des données pour une correspondance aussi bonne que possible. Il se rabat sur la locale par défaut si

• language est AnyLanguage et qu'aucune langue ne peut être déduite de script et que territory
• QLocale n'a pas de données pour la langue, qu'elle soit donnée comme language ou déduite comme ci-dessus.

Voir aussi setDefault() et Matching combinations of language, script and territory.

[explicit] QLocale::QLocale(const QString &name)

[noexcept] QLocale::QLocale(const QLocale &other)

Construit un objet QLocale comme une copie de other.

[noexcept] QLocale::~QLocale()

Destructeur

QString QLocale::amText() const

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

Voir aussi pmText().

QString QLocale::bcp47Name(QLocale::TagSeparator separator = TagSeparator::Dash) const

Renvoie les noms des champs BCP47 reliés par des tirets.

Cela combine autant de champs langue, script et territoire (et éventuellement d'autres champs BCP47) pour cette locale qu'il est nécessaire pour la spécifier de manière unique. Il convient de noter que des champs peuvent être omis si le consortium Unicode Likely Subtag Rules implique les champs omis lorsqu'ils sont retenus. Voir name() pour savoir comment construire une chaîne de caractères à partir de champs individuels, si un autre format est nécessaire.

Contrairement à uiLanguages(), la valeur renvoyée par bcp47Name() représente le nom de la locale des données de QLocale; il ne s'agit pas nécessairement de la langue dans laquelle l'interface utilisateur doit être rédigée.

Cette fonction tente de conformer le nom de la locale à la meilleure pratique commune 47 de l'IETF, définie par la RFC 5646. Depuis Qt 6.7, elle prend en charge un paramètre facultatif separator qui peut être utilisé pour remplacer l'utilisation d'un trait d'union pour séparer les balises, spécifiée par BCP47. Pour l'utilisation dans les protocoles définis par l'IETF, cependant, la valeur par défaut, QLocale::TagSeparator::Dash, doit être conservée.

Voir aussi name(), language(), territory(), script() et uiLanguages().

[static noexcept] QLocale QLocale::c()

Renvoie un objet QLocale initialisé à la locale "C".

Cette locale est basée sur en_US, mais présente diverses particularités, telles que le formatage simplifié des nombres et le formatage de la date. Elle met en œuvre les normes POSIX qui décrivent le comportement des fonctions de la bibliothèque standard du langage de programmation "C".

Cela signifie, entre autres, que son ordre de collation est basé sur les valeurs ASCII des lettres, de sorte que (pour le tri sensible à la casse) toutes les lettres majuscules sont triées avant toutes les lettres minuscules (plutôt que les formes majuscules et minuscules de chaque lettre soient triées l'une à côté de l'autre, avant les deux formes de la lettre suivante).

Voir également system().

[static noexcept, since 6.3] QLocale::Language QLocale::codeToLanguage(QStringView languageCode, QLocale::LanguageCodeTypes codeTypes = AnyLanguageCode)

Renvoie l'énumération QLocale::Language correspondant aux codes à deux ou trois lettres languageCode, tels qu'ils sont définis dans les normes ISO 639.

Si spécifié, codeTypes sélectionne l'ensemble des codes à prendre en compte pour la conversion. Par défaut, tous les codes connus de Qt sont pris en compte. Les codes sont comparés dans l'ordre suivant : ISO639Part1, ISO639Part2B, ISO639Part2T, ISO639Part3, LegacyLanguageCode.

Si le code est invalide ou inconnu, QLocale::AnyLanguage est renvoyé.

Cette fonction a été introduite dans Qt 6.3.

Voir aussi languageToCode(), codeToTerritory(), et codeToScript().

[static noexcept, since 6.1] QLocale::Script QLocale::codeToScript(QStringView scriptCode)

Renvoie l'énumération QLocale::Script correspondant au script à quatre lettres scriptCode, tel que défini dans la norme ISO 15924.

Si le code est invalide ou inconnu, QLocale::AnyScript est renvoyé.

Cette fonction a été introduite dans Qt 6.1.

Voir aussi scriptToCode(), codeToLanguage(), et codeToTerritory().

[static noexcept, since 6.2] QLocale::Territory QLocale::codeToTerritory(QStringView territoryCode)

Renvoie l'enum QLocale::Territory correspondant au code à deux lettres ou trois chiffres territoryCode, tel que défini dans la norme ISO 3166.

Si le code est invalide ou inconnu, QLocale::AnyTerritory est renvoyé.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi territoryToCode(), codeToLanguage(), et codeToScript().

QLocale QLocale::collation() const

Renvoie la locale à utiliser pour la collation.

Le résultat est généralement cette locale ; cependant, la locale du système (qui est généralement la locale par défaut) renverra la locale de collation du système. Le résultat peut être transmis au constructeur de QCollator.

Voir aussi QCollator.

QString QLocale::createSeparatedList(const QStringList &list) const

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.

QString QLocale::currencySymbol(QLocale::CurrencySymbolFormat format = CurrencySymbol) const

Renvoie un symbole de devise selon le modèle format.

QString QLocale::dateFormat(QLocale::FormatType format = LongFormat) const

Renvoie le format de date utilisé pour la locale actuelle.

Si format est LongFormat, le format sera élaboré, sinon il sera court. Par exemple, LongFormat pour la locale en_US est dddd, MMMM d, yyyy, ShortFormat est M/d/yy.

Voir également QDate::toString() et QDate::fromString().

QString QLocale::dateTimeFormat(QLocale::FormatType format = LongFormat) const

Renvoie le format de date et d'heure utilisé pour la locale actuelle.

Si format est LongFormat, le format sera élaboré, sinon il sera court. Par exemple, LongFormat pour la locale en_US est dddd, MMMM d, yyyy h:mm:ss AP t, ShortFormat est M/d/yy h:mm AP.

Voir également QDateTime::toString() et QDateTime::fromString().

QString QLocale::dayName(int day, QLocale::FormatType type = LongFormat) const

Renvoie le nom localisé de day (où 1 représente le lundi, 2 le mardi et ainsi de suite), dans le format spécifié par type.

Par exemple, si la locale est en_US et que day est 1, LongFormat renverra Monday, ShortFormat Mon , et NarrowFormat M .

Voir également monthName() et standaloneDayName().

QString QLocale::decimalPoint() const

Renvoie le séparateur de parties fractionnaires pour cette locale.

Il s'agit du jeton qui sépare la partie entière du nombre de la partie fractionnaire dans la représentation d'un nombre qui a une partie fractionnaire. Il est communément appelé le "caractère de point décimal" - même si, dans de nombreuses locales, il ne s'agit pas d'un "point" (ou d'un point similaire). Il est (depuis Qt 6.0) retourné sous forme de chaîne de caractères au cas où une locale aurait besoin de plus d'un point de code UTF-16 pour représenter son séparateur.

Voir aussi groupSeparator() et toString().

QString QLocale::exponential() const

Renvoie le séparateur d'exposant pour cette locale.

Il s'agit d'un jeton utilisé pour séparer la mantisse de l'exposant dans certaines représentations numériques en virgule flottante. Il est (depuis Qt 6.0) retourné sous la forme d'une chaîne de caractères car, dans certaines locales, il ne s'agit pas d'un caractère unique - par exemple, il peut s'agir d'un signe de multiplication et d'une représentation de l'opérateur "dix à la puissance".

Voir aussi toString(double, char, int).

Qt::DayOfWeek QLocale::firstDayOfWeek() const

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

QString QLocale::formattedDataSize(qint64 bytes, int precision = 2, QLocale::DataSizeFormats format = DataSizeIecFormat) const

Convertit une taille en octets en une chaîne localisée lisible par l'homme, comprenant un nombre et une unité quantifiée. Le quantificateur est choisi de manière à ce que le nombre soit au moins égal à un, et aussi petit que possible. Par exemple, si bytes est 16384, precision est 2, et format est DataSizeIecFormat (par défaut), cette fonction renvoie "16.00 KiB" ; pour 1330409069609 octets, elle renvoie "1.21 GiB" ; et ainsi de suite. Si format est DataSizeIecFormat ou DataSizeTraditionalFormat, le nombre d'octets donné est divisé par une puissance de 1024, avec un résultat inférieur à 1024 ; pour DataSizeSIFormat, il est divisé par une puissance de 1000, avec un résultat inférieur à 1000. DataSizeIecFormat utilise les nouveaux quantificateurs standard de la CEI Ki, Mi, etc., alors que DataSizeSIFormat utilise les anciens quantificateurs SI k, M, etc., et DataSizeTraditionalFormat en abuse.

QString QLocale::groupSeparator() const

Renvoie le séparateur de groupes de chiffres pour cette locale.

Il s'agit d'un jeton utilisé pour séparer les longues séquences de chiffres dans la représentation d'un nombre, afin d'en faciliter la lecture. Dans certaines locales, il peut être vide, ce qui indique que les chiffres ne doivent pas être divisés en groupes de cette manière. Dans d'autres, il peut s'agir d'un caractère d'espacement. Il est (depuis Qt 6.0) retourné sous forme de chaîne de caractères au cas où une locale aurait besoin de plus d'un point de code UTF-16 pour représenter son séparateur.

Voir aussi decimalPoint() et toString().

QLocale::Language QLocale::language() const

Renvoie la langue de cette locale.

Voir aussi script(), territory(), languageToString() et bcp47Name().

[static, since 6.3] QString QLocale::languageToCode(QLocale::Language language, QLocale::LanguageCodeTypes codeTypes = AnyLanguageCode)

Renvoie le code de langue à deux ou trois lettres pour language, tel que défini dans les normes ISO 639.

S'il est spécifié, codeTypes sélectionne l'ensemble des codes à prendre en compte. Le premier code de l'ensemble défini pour language est renvoyé. Sinon, tous les codes ISO-639 sont pris en compte. Les codes sont pris en compte dans l'ordre suivant : ISO639Part1, ISO639Part2B, ISO639Part2T, ISO639Part3. LegacyLanguageCode est ignoré par cette fonction.

Cette fonction a été introduite dans Qt 6.3.

Voir aussi codeToLanguage(), language(), name(), bcp47Name(), territoryToCode() et scriptToCode().

[static] QString QLocale::languageToString(QLocale::Language language)

Renvoie un QString contenant le nom de language.

Voir aussi territoryToString(), scriptToString(), et bcp47Name().

[static] QList<QLocale> QLocale::matchingLocales(QLocale::Language language, QLocale::Script script, QLocale::Territory territory)

Renvoie une liste d'objets linguistiques valides correspondant aux paramètres language, script et territory.

Obtention d'une liste de toutes les locales : QList<QLocale> allLocales = QLocale::matchingLocales(QLocale::AnyLanguage, QLocale::AnyScript, QLocale::AnyTerritory) ;

Obtention d'une liste de locales adaptées à la Russie : QList<QLocale> locales = QLocale::matchingLocales(QLocale::AnyLanguage, QLocale::AnyScript, QLocale::Russia) ;

QLocale::MeasurementSystem QLocale::measurementSystem() const

Renvoie le système de mesure de la locale.

QString QLocale::monthName(int month, QLocale::FormatType type = LongFormat) const

Renvoie le nom localisé de month, dans le format spécifié par type.

Par exemple, si la locale est en_US et que month est 1, LongFormat renverra January. ShortFormat Jan et NarrowFormat J .

Voir aussi dayName() et standaloneMonthName().

QString QLocale::name(QLocale::TagSeparator separator = TagSeparator::Underscore) const

Le nom court de cette locale.

Renvoie 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 à deux lettres en minuscules, et territoire est un code de territoire ISO 3166 à deux ou trois lettres en majuscules. Si la locale n'a pas de territoire spécifié, seul le nom de la langue est renvoyé. Depuis Qt XML 6.7, un paramètre facultatif separator peut être fourni pour remplacer le caractère de soulignement par défaut qui sépare les deux balises.

Même si l'objet QLocale a été construit avec un script explicite, name() ne le contiendra pas pour des raisons de compatibilité. Utilisez plutôt bcp47Name() si vous avez besoin d'un nom de locale complet, ou construisez la chaîne par laquelle vous voulez identifier une locale à partir de celles renvoyées en passant son language() à languageToCode() et similaires pour le script et le territoire.

Voir aussi QLocale(), language(), script(), territory(), bcp47Name() et uiLanguages().

QString QLocale::nativeLanguageName() const

Renvoie un nom natif de la langue pour les paramètres régionaux. Par exemple, "Schweizer Hochdeutsch" pour les paramètres régionaux suisses-allemands.

Voir aussi nativeTerritoryName() et languageToString().

[since 6.2] QString QLocale::nativeTerritoryName() const

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

Cette fonction a été introduite dans Qt 6.2.

Voir aussi nativeLanguageName() et territoryToString().

QString QLocale::negativeSign() const

Renvoie l'indicateur de signe négatif de cette locale.

Il s'agit d'un jeton supposé être utilisé comme préfixe d'un nombre pour indiquer qu'il est négatif. Il est (depuis Qt 6.0) retourné sous forme de chaîne de caractères car, dans certaines locales, il ne s'agit pas d'un caractère unique - par exemple, parce qu'il inclut un caractère de contrôle de la direction du texte.

Voir aussi positiveSign() et toString().

QLocale::NumberOptions QLocale::numberOptions() const

Renvoie les options relatives à la conversion des nombres pour cette instance QLocale.

Par défaut, aucune option n'est définie pour les locales standard, à l'exception de la locale "C", pour laquelle OmitGroupSeparator est défini par défaut.

Voir aussi setNumberOptions(), toString(), groupSeparator() et FloatingPointPrecisionOption.

QString QLocale::percent() const

Renvoie le marqueur de pourcentage de cette locale.

Il s'agit d'un jeton supposé être ajouté à un nombre pour indiquer un pourcentage. Il est (depuis Qt 6.0) retourné sous forme de chaîne de caractères car, dans certaines locales, il ne s'agit pas d'un caractère unique - par exemple, parce qu'il inclut un caractère de contrôle de la direction du texte.

Voir aussi toString().

QString QLocale::pmText() const

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

Voir aussi amText().

QString QLocale::positiveSign() const

Renvoie l'indicateur de signe positif de cette locale.

Il s'agit d'un jeton supposé être utilisé comme préfixe d'un nombre pour indiquer qu'il est positif. Il est (depuis Qt 6.0) retourné sous forme de chaîne de caractères car, dans certaines locales, il ne s'agit pas d'un caractère unique - par exemple, parce qu'il inclut un caractère de contrôle de la direction du texte.

Voir aussi negativeSign() et toString().

QString QLocale::quoteString(const QString &str, QLocale::QuotationStyle style = StandardQuotation) const

Renvoie str avec une citation conforme à la langue locale actuelle, en utilisant la citation donnée style.

[since 6.0] QString QLocale::quoteString(QStringView str, QLocale::QuotationStyle style = StandardQuotation) const

Cette fonction a été introduite dans Qt 6.0.

QLocale::Script QLocale::script() const

Renvoie le script de cette locale.

Voir aussi language(), territory(), languageToString(), scriptToString() et bcp47Name().

[static, since 6.1] QString QLocale::scriptToCode(QLocale::Script script)

Renvoie le code de script à quatre lettres pour script, tel que défini dans la norme ISO 15924.

Cette fonction a été introduite dans Qt 6.1.

Voir aussi script(), name(), bcp47Name(), languageToCode() et territoryToCode().

[static] QString QLocale::scriptToString(QLocale::Script script)

Renvoie un QString contenant le nom de script.

Voir aussi languageToString(), territoryToString(), script(), et bcp47Name().

[static] void QLocale::setDefault(const QLocale &locale)

Fixe la locale globale par défaut à locale.

Cette locale est utilisée lorsqu'un objet QLocale est construit sans arguments. Si cette fonction n'est pas appelée, la locale du système est utilisée.

Attention : Cette fonction n'est pas réentrante.

Voir aussi system() et c().

void QLocale::setNumberOptions(QLocale::NumberOptions options)

Définit les paramètres options relatifs aux conversions de nombres pour cette instance QLocale.

Voir également numberOptions() et FloatingPointPrecisionOption.

QString QLocale::standaloneDayName(int day, QLocale::FormatType type = LongFormat) const

Renvoie le nom localisé du jour day (où 1 représente le lundi, 2 le mardi, etc.) qui est utilisé comme texte autonome, dans le format 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 également dayName() et standaloneMonthName().

QString QLocale::standaloneMonthName(int month, QLocale::FormatType type = LongFormat) const

Renvoie le nom localisé de month qui est utilisé comme texte autonome, dans le format spécifié 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().

[noexcept] void QLocale::swap(QLocale &other)

Remplace cette locale par other. Cette opération est très rapide et n'échoue jamais.

[static] QLocale QLocale::system()

Renvoie un objet QLocale initialisé à la locale du système.

La locale du système peut utiliser des sources spécifiques au système pour les données de la locale, lorsqu'elles sont disponibles, sinon elle s'appuie sur l'entrée de la base de données intégrée de QLocale pour la langue, le script et le territoire que le système signale.

Par exemple, sous Windows et Mac, ces paramètres régionaux utiliseront les caractères décimaux/de regroupement et les formats de date et d'heure spécifiés dans le panneau de configuration du système.

Voir également c().

[since 6.2] QLocale::Territory QLocale::territory() const

Renvoie le territoire de cette locale.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi language(), script(), territoryToString(), et bcp47Name().

[static, since 6.2] QString QLocale::territoryToCode(QLocale::Territory territory)

Renvoie le code de territoire à deux lettres pour territory, tel que défini dans la norme ISO 3166.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi codeToTerritory(), territory(), name(), bcp47Name(), languageToCode() et scriptToCode().

[static, since 6.2] QString QLocale::territoryToString(QLocale::Territory territory)

Retourne un QString contenant le nom de territory.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi languageToString(), scriptToString(), territory() et bcp47Name().

Qt::LayoutDirection QLocale::textDirection() const

Renvoie le sens du texte de la langue.

QString QLocale::timeFormat(QLocale::FormatType format = LongFormat) const

Renvoie le format de l'heure utilisé pour la locale actuelle.

Si format est LongFormat, le format sera élaboré, sinon il sera court. Par exemple, LongFormat pour la locale en_US est h:mm:ss AP t, ShortFormat est h:mm AP.

Voir également QTime::toString() et QTime::fromString().

QString QLocale::toCurrencyString(qlonglong value, const QString &symbol = QString()) const

Renvoie une représentation sous forme de chaîne de caractères localisée de value en tant que devise. Si symbol est fourni, il est utilisé à la place du symbole monétaire par défaut.

Voir aussi currencySymbol().

QString QLocale::toCurrencyString(int value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(qulonglong value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(short value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(uint value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(ushort value, const QString &symbol = QString()) const

QString QLocale::toCurrencyString(double value, const QString &symbol = QString(), int precision = -1) const

Renvoie une représentation sous forme de chaîne de caractères localisée de value en tant que devise. Si symbol est fourni, il est utilisé à la place du symbole monétaire par défaut. Si precision est fourni, il est utilisé pour définir la précision de la valeur de la devise.

Voir aussi currencySymbol().

QString QLocale::toCurrencyString(float i, const QString &symbol = QString(), int precision = -1) const

QDate QLocale::toDate(const QString &string, QLocale::FormatType format = LongFormat, int baseYear = DefaultTwoDigitBaseYear) const

Lit string comme une date dans une version locale de format.

Analyse string et renvoie la date qu'il représente. Le format de la chaîne de date est choisi en fonction du paramètre format (voir dateFormat()).

Certaines locales n'utilisent, notamment pour ShortFormat, que les deux derniers chiffres de l'année. Dans ce cas, les 100 années commençant à baseYear sont les premières candidates considérées. Avant la version 6.7, il n'y avait pas de paramètre baseYear et 1900 était toujours utilisé. C'est la valeur par défaut de baseYear, qui sélectionne une année entre cette date et 1999. Dans certains cas, d'autres champs peuvent conduire à la sélection du siècle suivant ou précédent, afin d'obtenir un résultat cohérent avec tous les champs fournis. Voir QDate::fromString() pour plus de détails.

Si la date n'a pas pu être analysée, renvoie une date invalide.

Voir aussi dateFormat(), toTime(), toDateTime() et QDate::fromString().

QDate QLocale::toDate(const QString &string, const QString &format, int baseYear = DefaultTwoDigitBaseYear) const

Lit string comme une date dans format.

Analyse string et renvoie la date qu'il représente. Voir QDate::fromString() pour l'interprétation de format.

Lorsque format ne spécifie que les deux derniers chiffres d'une année, les 100 années commençant à baseYear sont les premières candidates prises en compte. Avant la version 6.7, il n'y avait pas de paramètre baseYear et 1900 était toujours utilisé. C'est la valeur par défaut de baseYear, qui sélectionne une année entre cette date et 1999. Dans certains cas, d'autres champs peuvent conduire à la sélection du siècle suivant ou précédent, afin d'obtenir un résultat cohérent avec tous les champs fournis. Voir QDate::fromString() pour plus de détails.

Si la date n'a pas pu être analysée, renvoie une date invalide.

Voir aussi dateFormat(), toTime(), toDateTime() et QDate::fromString().

QDate QLocale::toDate(const QString &string, QLocale::FormatType format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

QDate QLocale::toDate(const QString &string, const QString &format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

QDateTime QLocale::toDateTime(const QString &string, QLocale::FormatType format = LongFormat, int baseYear = DefaultTwoDigitBaseYear) const

Lit string en tant que date-heure dans un format local format.

Analyse string et renvoie la date-heure qu'il représente. Le format de la chaîne de date est choisi en fonction du paramètre format (voir dateFormat()).

Certaines locales n'utilisent que les deux derniers chiffres de l'année, en particulier pour ShortFormat. Dans ce cas, les 100 années commençant à baseYear sont les premières candidates considérées. Avant la version 6.7, il n'y avait pas de paramètre baseYear et 1900 était toujours utilisé. C'est la valeur par défaut de baseYear, qui sélectionne une année entre cette date et 1999. Dans certains cas, d'autres champs peuvent conduire à la sélection du siècle suivant ou précédent, afin d'obtenir un résultat cohérent avec tous les champs fournis. Voir QDate::fromString() pour plus de détails.

Si la chaîne n'a pas pu être analysée, elle renvoie une adresse invalide QDateTime.

Voir aussi dateTimeFormat(), toTime(), toDate() et QDateTime::fromString().

QDateTime QLocale::toDateTime(const QString &string, const QString &format, int baseYear = DefaultTwoDigitBaseYear) const

Lit string comme une date-heure dans format.

Analyse string et renvoie la date-heure qu'il représente. Voir QDateTime::fromString() pour l'interprétation de format.

Lorsque format ne spécifie que les deux derniers chiffres d'une année, les 100 années commençant à baseYear sont les premières candidates prises en compte. Avant la version 6.7, il n'y avait pas de paramètre baseYear et 1900 était toujours utilisé. C'est la valeur par défaut de baseYear, qui sélectionne une année entre cette date et 1999. Dans certains cas, d'autres champs peuvent conduire à la sélection du siècle suivant ou précédent, afin d'obtenir un résultat cohérent avec tous les champs fournis. Voir QDate::fromString() pour plus de détails.

Si la chaîne n'a pas pu être analysée, le système renvoie une adresse invalide QDateTime. Si la chaîne peut être analysée et représente une date-heure invalide (par exemple, dans un intervalle ignoré par une transition de fuseau horaire), le système renvoie une adresse invalide QDateTime, dont la fonction toMSecsSinceEpoch() représente une date-heure proche qui est valide. Passer cela à fromMSecsSinceEpoch() produira une date-heure valide qui n'est pas fidèlement représentée par la chaîne analysée.

Voir aussi dateTimeFormat(), toTime(), toDate(), et QDateTime::fromString().

QDateTime QLocale::toDateTime(const QString &string, QLocale::FormatType format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

QDateTime QLocale::toDateTime(const QString &string, const QString &format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const

double QLocale::toDouble(QStringView s, bool *ok = nullptr) const

Renvoie le double représenté par la chaîne localisée s.

Renvoie une infinité si la conversion déborde ou 0.0 si la conversion échoue pour une autre raison (par exemple, un débordement).

Si ok n'est pas nullptr, l'échec est signalé par l'affectation de *ok à false, et la réussite par l'affectation de *ok à true.

bool ok;
double d;

QLocale c(QLocale::C);
d = c.toDouble(u"1234.56", &ok);  // ok == true,  d == 1234.56
d = c.toDouble(u"1,234.56", &ok); // ok == true,  d == 1234.56
d = c.toDouble(u"1234,56", &ok);  // ok == false, d == 0

QLocale german(QLocale::German);
d = german.toDouble(u"1234,56", &ok);  // ok == true,  d == 1234.56
d = german.toDouble(u"1.234,56", &ok); // ok == true,  d == 1234.56
d = german.toDouble(u"1234.56", &ok);  // ok == false, d == 0

d = german.toDouble(u"1.234", &ok);    // ok == true,  d == 1234.0

Notez que la dernière conversion renvoie 1234.0, car '.' est le séparateur de groupes de milliers dans la locale allemande.

Cette fonction ignore les espaces blancs de début et de fin.

Voir aussi toFloat(), toInt() et toString().

double QLocale::toDouble(const QString &s, bool *ok = nullptr) const

Renvoie le double représenté par la chaîne localisée s.

Renvoie une infinité si la conversion déborde ou 0.0 si la conversion échoue pour une autre raison (par exemple, un débordement).

Si ok n'est pas nullptr, l'échec est signalé par l'affectation de *ok à false, et la réussite par l'affectation de *ok à true.

bool ok;
double d;

QLocale c(QLocale::C);
d = c.toDouble("1234.56", &ok);  // ok == true,  d == 1234.56
d = c.toDouble("1,234.56", &ok); // ok == true,  d == 1234.56
d = c.toDouble("1234,56", &ok);  // ok == false, d == 0

QLocale german(QLocale::German);
d = german.toDouble("1234,56", &ok);  // ok == true,  d == 1234.56
d = german.toDouble("1.234,56", &ok); // ok == true,  d == 1234.56
d = german.toDouble("1234.56", &ok);  // ok == false, d == 0

d = german.toDouble("1.234", &ok);    // ok == true,  d == 1234.0

Notez que la dernière conversion renvoie 1234.0, car '.' est le séparateur de groupes de milliers dans la locale allemande.

Cette fonction ignore les espaces blancs de début et de fin.

Voir aussi toFloat(), toInt() et toString().

float QLocale::toFloat(QStringView s, bool *ok = nullptr) const

Renvoie le flotteur représenté par la chaîne de caractères localisée s.

Renvoie une infinité si la conversion déborde ou 0.0 si la conversion échoue pour une autre raison (par exemple, un débordement).

Si ok n'est pas nullptr, l'échec est signalé par l'affectation de *ok à false, et la réussite par l'affectation de *ok à true.

Cette fonction ignore les espaces blancs de début et de fin.

Voir également toDouble(), toInt() et toString().

float QLocale::toFloat(const QString &s, bool *ok = nullptr) const

Renvoie le flotteur représenté par la chaîne de caractères localisée s.

Renvoie une infinité si la conversion déborde ou 0.0 si la conversion échoue pour une autre raison (par exemple, un débordement).

Si ok n'est pas nullptr, l'échec est signalé par l'affectation de *ok à false, et la réussite par l'affectation de *ok à true.

Cette fonction ignore les espaces blancs de début et de fin.

Voir également toDouble(), toInt() et toString().

int QLocale::toInt(QStringView s, bool *ok = nullptr) const

Renvoie l'int représenté par la chaîne localisée s.

Si la conversion échoue, la fonction renvoie 0.

Si ok n'est pas nullptr, l'échec est signalé par la définition de *ok en false, et la réussite par la définition de *ok en true.