QLocale Class

Documentation sur les fonctions membres

QLocale::QLocale()

Crée un objet QLocale initialisé avec les paramètres régionaux par défaut.

Si aucune locale par défaut n’a été définie à l’aide de la fonction ` setDefault()`, cette locale sera identique à celle renvoyée par la fonction ` system()`.

Voir également setDefault() et system().

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

Crée un objet QLocale avec l'name spécifiée.

Le nom a le format « langue[_script][_territoire][.jeu de caractères][@modificateur] » ou « C », où :

• « language » est un code de langue ISO 639 à deux lettres en minuscules (certains codes à trois lettres sont également reconnus),
• script est un code de script ISO 15924 de quatre lettres en majuscules,
• territoire est un code de territoire ISO 3166 à deux lettres en majuscules (certains codes numériques sont également reconnus), et
• codeset et modifier sont ignorés.

Le séparateur peut être soit un trait de soulignement '_' (U+005F, « ligne basse »), soit un tiret '-' (U+002D, « trait d’union »). Si QLocale ne dispose d’aucune donnée pour la combinaison spécifiée de langue, d’écriture et de territoire, il utilise alors la correspondance la plus appropriée qu’il peut trouver. Si la chaîne ne respecte pas le format de 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(Langue, Écriture, Territoire) ou QLocale(Langue, Territoire).

Cette fonction a été introduite dans Qt 6.3.

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

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

Crée un objet QLocale pour l'language et l'territory spécifiées.

S'il existe plusieurs scripts pour cette combinaison, un script probable sera sélectionné. Si QLocale ne dispose d'aucune donnée pour l'language spécifiée, la locale par défaut est utilisée. Si QLocale ne dispose d'aucune donnée pour la combinaison spécifiée de language et territory, un autre territoire peut être utilisé à la place.

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

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

Crée un objet QLocale pour les paramètres spécifiés : language, script et territory.

Si QLocale ne dispose pas de données pour la combinaison donnée, il recherchera les données correspondant le mieux possible. Il se rabattra sur la locale par défaut si

• language AnyLanguage et qu’aucune langue ne peut être déduite de et script territory
• QLocale ne dispose d’aucune donnée pour la langue, qu’elle soit fournie sous la forme language ou déduite comme ci-dessus.

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

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

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

Crée un objet QLocale qui est une copie de other.

[noexcept] QLocale::~QLocale()

Destructeur

QString QLocale::amText() const

Renvoie le nom localisé du suffixe « AM » pour les heures exprimées selon le format de 12 heures.

Voir aussi pmText().

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

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

Cette chaîne combine autant de champs « language », « script » et « territory » (et éventuellement d’autres champs BCP47) pour cette locale que nécessaire afin de la spécifier de manière unique. Notez que certains champs peuvent être omis si les spécifications de la norme « Likely Subtag Rules » du consortium Unicode permettent de déduire les champs omis à partir de ceux qui sont conservés. Consultez name() pour savoir comment construire une chaîne à partir de champs individuels, si un autre format est nécessaire.

Contrairement à uiLanguages(), la valeur renvoyée par bcp47Name() représente le nom de locale des données de la norme « QLocale » ; il ne s’agit pas nécessairement de la langue dans laquelle l’interface utilisateur doit s’afficher.

Cette fonction tente de conformer le nom de locale à la « Best Common Practice 47 » de l’IETF, définie par la RFC 5646. Depuis Qt 6.7, elle prend en charge un paramètre optionnel separator qui peut être utilisé pour remplacer l’utilisation d’un trait d’union, spécifiée par la BCP47, pour séparer les balises. Pour une utilisation dans les protocoles définis par l’IETF, il convient toutefois de conserver la valeur par défaut, ` QLocale::TagSeparator::Dash`.

Voir également name(), language(), territory(), script() et uiLanguages().

[static noexcept] QLocale QLocale::c()

Renvoie un objet ` QLocale ` initialisé selon la locale « C ».

Cette locale est basée sur en_US mais présente certaines particularités qui lui sont propres, telles qu’un formatage simplifié des nombres et un formatage spécifique des dates. 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 notamment que son ordre de classement est basé sur les valeurs ASCII des lettres, de sorte que (pour un tri tenant compte de la casse) toutes les lettres majuscules sont classées avant les minuscules (plutôt que de classer les formes majuscules et minuscules d’une même lettre 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 au code de langue à deux ou trois lettres « languageCode », tel que défini dans les normes ISO 639.

Si elle est spécifiée, la valeur codeTypes permet de sélectionner l’ensemble de codes à prendre en compte pour la conversion. Par défaut, tous les codes connus de Qt sont pris en compte. Les codes sont mis en correspondance dans l’ordre suivant : ISO639Part1, ISO639Part2B, ISO639Part2T, ISO639Part3, LegacyLanguageCode.

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

Cette fonction a été introduite dans Qt 6.3.

Voir également languageToCode(), codeToTerritory() et codeToScript().

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

Renvoie la valeur de l'énumération « QLocale::Script » correspondant à l'scriptCode d'un script à quatre lettres, telle que définie dans la norme ISO 15924.

Si le code n'est pas valide ou inconnu, la valeur QLocale::AnyScript est renvoyée.

Cette fonction a été introduite dans Qt 6.1.

Voir également scriptToCode(), codeToLanguage() et codeToTerritory().

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

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

Si le code n'est pas valide ou inconnu, QLocale::AnyTerritory est renvoyé.

Cette fonction a été introduite dans Qt 6.2.

Voir également territoryToCode(), codeToLanguage() et codeToScript().

QLocale QLocale::collation() const

Renvoie les paramètres régionaux à utiliser pour le classement.

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

Voir également QCollator.

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

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

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

Renvoie un symbole monétaire conformément à la norme « format ».

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

Renvoie le format de date utilisé pour les paramètres régionaux actuels.

Si la valeur de ` format ` est ` LongFormat`, le format sera détaillé ; dans le cas contraire, il sera abrégé. Par exemple, ` LongFormat ` pour la locale en_US correspond à ` dddd, MMMM d, yyyy`, et ` ShortFormat ` correspond à ` 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 les paramètres régionaux actuels.

Si la valeur de format est LongFormat, le format sera détaillé ; sinon, il sera abrégé. Par exemple, LongFormat pour la locale en_US donne dddd, MMMM d, yyyy h:mm:ss AP t, et ShortFormat donne 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 l'day (où 1 correspond au lundi, 2 au mardi, et ainsi de suite), au format spécifié par type.

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

Voir également monthName() et standaloneDayName().

QString QLocale::decimalPoint() const

Renvoie le séparateur de la partie fractionnaire pour cette locale.

Il s'agit du caractère qui sépare la partie entière de la partie fractionnaire dans la représentation d'un nombre comportant une partie fractionnaire. On l'appelle communément « caractère de la virgule décimale », même si, dans de nombreuses locales, il ne s'agit pas d'un « point » (ou d'un caractère similaire). Il est (depuis Qt 6.0) renvoyé sous forme de chaîne de caractères au cas où certaines paramètres régionales nécessiteraient plus d’un point de code UTF-16 pour représenter leur séparateur.

Voir également groupSeparator() et toString().

QString QLocale::exponential() const

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

Il s'agit d'un token utilisé pour séparer la mantisse de l'exposant dans certaines représentations numériques à virgule flottante. Il est (depuis Qt 6.0) renvoyé sous forme de chaîne de caractères car, dans certaines locales, il ne s'agit pas d'un seul caractère — par exemple, il peut être composé d'un signe de multiplication et d'une représentation de l'opérateur « dix à la puissance ».

Voir également ` toString` (double, char, int).

Qt::DayOfWeek QLocale::firstDayOfWeek() const

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

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

Convertit une taille exprimée en octets en une chaîne localisée lisible par l'utilisateur, composée d'un nombre et d'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 vaut 16384, precision vaut 2 et format vaut DataSizeIecFormat (valeur 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 1 024, le résultat étant inférieur à 1 024 ; pour DataSizeSIFormat, il est divisé par une puissance de 1 000, le résultat étant inférieur à 1 000. DataSizeIecFormat utilise les nouveaux quantificateurs de la norme CEI Ki, Mi, etc., tandis que DataSizeSIFormat utilise les anciens quantificateurs SI k, M, etc., et que DataSizeTraditionalFormat en fait un usage abusif.

QString QLocale::groupSeparator() const

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

Il s'agit d'un token 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 regroupés de cette manière. Dans d'autres, il peut s'agir d'un caractère d'espacement. Depuis Qt 6.0, il est renvoyé sous forme de chaîne de caractères au cas où certaines paramètres régionales nécessiteraient plus d'un point de code UTF-16 pour représenter leur séparateur.

Voir également decimalPoint() et toString().

QLocale::Language QLocale::language() const

Renvoie la langue de cette locale.

Voir également 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 permet de sélectionner l’ensemble de 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 également codeToLanguage(), language(), name(), bcp47Name(), territoryToCode() et scriptToCode().

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

Renvoie un objet ` QString ` contenant le nom de ` language`.

Voir également territoryToString(), scriptToString() et bcp47Name().

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

Renvoie une liste d’objets de paramètres régionaux valides correspondant aux valeurs fournies pour language, script et territory.

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

Récupération 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 mesures associé à la configuration régionale.

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

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

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

Voir également dayName() et standaloneMonthName().

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

Le nom abrégé de cette locale.

Renvoie la langue et le territoire de cette locale sous la forme d'une chaîne de caractères « 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 6.7, un paramètre facultatif separator peut être fourni pour remplacer le caractère de séparation par défaut (trait de soulignement) entre les deux balises.

Même si l’objet ` QLocale ` a été construit avec un script explicite, la fonction `name()` ne l’inclura 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 permettant d’identifier une locale à partir de celles renvoyées en passant son ` language()` à ` languageToCode()` et de manière similaire pour le script et le territoire.

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

QString QLocale::nativeLanguageName() const

Renvoie le nom en langue locale correspondant à la locale. Par exemple, « Schweizer Hochdeutsch » pour la locale « suisse-allemand ».

Voir également nativeTerritoryName() et languageToString().

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

Renvoie le nom en langue locale du territoire correspondant à la locale. Par exemple, « España » pour la locale « Espagnol/Espagne ».

Cette fonction a été introduite dans Qt 6.2.

Voir également nativeLanguageName() et territoryToString().

QString QLocale::negativeSign() const

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

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

Voir également positiveSign() et toString().

QLocale::NumberOptions QLocale::numberOptions() const

Renvoie les options relatives aux conversions numériques pour cette instance d'QLocale.

Par défaut, aucune option n’est définie pour les locales standard, à l’exception de la locale « C », pour laquelle l’option « OmitGroupSeparator » est activée par défaut.

Voir également setNumberOptions(), toString(), groupSeparator() et FloatingPointPrecisionOption.

QString QLocale::percent() const

Renvoie le caractère représentant le pourcentage pour cette locale.

Il s'agit d'un token censé être ajouté à un nombre pour indiquer un pourcentage. Depuis Qt 6.0, il est renvoyé sous forme de chaîne de caractères car, dans certaines locales, il ne s'agit pas d'un seul caractère — par exemple, parce qu'il inclut un caractère de contrôle de la direction du texte.

Voir également toString().

QString QLocale::pmText() const

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

Voir également amText().

QString QLocale::positiveSign() const

Renvoie l'indicateur de signe positif de cette locale.

Il s'agit d'un token censé être utilisé comme préfixe d'un nombre pour indiquer que celui-ci est positif. Depuis Qt 6.0, il est renvoyé sous forme de chaîne de caractères car, dans certaines locales, il ne s'agit pas d'un seul caractère — par exemple, parce qu'il inclut un caractère de contrôle de la direction du texte.

Voir également negativeSign() et toString().

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

Renvoie la chaîne « str » mise entre guillemets selon les paramètres régionaux actuels, en utilisant l'style de mise entre guillemets indiquée.

[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 associé à cette locale.

Voir également language(), territory(), languageToString(), scriptToString() et bcp47Name().

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

Renvoie le code d'écriture à quatre lettres correspondant à « script », tel que défini dans la norme ISO 15924.

Cette fonction a été introduite dans Qt 6.1.

Voir également : script(), name(), bcp47Name(), languageToCode() et territoryToCode().

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

Renvoie un objet de type « QString » contenant le nom de script.

Voir également languageToString(), territoryToString(), script() et bcp47Name().

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

Définit les paramètres régionaux globaux par défaut sur « locale ».

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

Avertissement : cette fonction n’est pas réentrante.

Voir également system() et c().

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

Définit les paramètres « options » liés aux conversions numériques pour cette instance d'QLocale.

Voir également ` numberOptions()` et ` FloatingPointPrecisionOption`.

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

Renvoie le nom localisé de l'day (où 1 correspond au lundi, 2 au mardi, et ainsi de suite) utilisé comme texte autonome, au format spécifié par type.

Si les informations de locale 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().

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

Renvoie le nom localisé de « month » utilisé en tant que texte isolé, au format spécifié par « type ».

Si les informations de localisation ne spécifient 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().

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

Permute cette locale avec celle de other. Cette opération est très rapide et ne rencontre jamais d'échec.

[static] QLocale QLocale::system()

Renvoie un objet ` QLocale ` initialisé selon les paramètres régionaux du système.

Les paramètres régionaux du système peuvent utiliser des sources spécifiques au système pour les données régionales, lorsqu'elles sont disponibles ; dans le cas contraire, ils se rabattent sur l'entrée de la base de données intégrée d'QLocale correspondant à la langue, à l'alphabet et au territoire indiqués par le système.

Par exemple, sous Windows et Mac, cette locale utilisera les caractères de séparation décimale et de regroupement, ainsi que 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 associé à cette locale.

Cette fonction a été introduite dans Qt 6.2.

Voir également language(), script(), territoryToString() et bcp47Name().

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

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

Cette fonction a été introduite dans Qt 6.2.

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

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

Renvoie un objet de type ` QString ` contenant le nom de ` territory`.

Cette fonction a été introduite dans Qt 6.2.

Voir également languageToString(), scriptToString(), territory() et bcp47Name().

Qt::LayoutDirection QLocale::textDirection() const

Renvoie le sens d'écriture de la langue.

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

Renvoie le format d'heure utilisé pour les paramètres régionaux actuels.

Si la valeur de ` format ` est ` LongFormat`, le format sera détaillé ; sinon, il sera court. Par exemple, ` LongFormat ` pour la locale ` en_US ` donne ` h:mm:ss AP t`, et ` ShortFormat ` donne ` 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 localisée de « value » en tant que devise. Si l'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 localisée de value en tant que devise. Si le paramètre symbol est fourni, il est utilisé à la place du symbole monétaire par défaut. Si le paramètre precision est fourni, il sert à définir la précision de la valeur monétaire.

Voir également 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

Interprète « string » comme une date selon le format spécifique à la locale format.

Analyse « string » et renvoie la date qu’elle 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 prises en compte. Avant la version 6.7, le paramètre baseYear n'existait pas et l'année 1900 était toujours utilisée. C'est la valeur par défaut pour baseYear, qui permet de sélectionner une année comprise entre cette date et 1999. Dans certains cas, d'autres champs peuvent entraîner la sélection du siècle suivant ou précédent, afin d'obtenir un résultat cohérent avec l'ensemble des champs renseignés. Voir QDate::fromString() pour plus de détails.

Si la date n’a pas pu être analysée, renvoie une date non valide.

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

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

Interprète string comme une date au format spécifié 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 par baseYear sont les premières prises en compte. Avant la version 6.7, il n’existait pas de paramètre baseYear et l’année 1900 était toujours utilisée. C’est la valeur par défaut pour baseYear, qui permet de sélectionner une année comprise entre cette date et 1999. Dans certains cas, d’autres champs peuvent entraîner la sélection du siècle suivant ou précédent, afin d’obtenir un résultat cohérent avec l’ensemble des champs fournis. Voir QDate::fromString() pour plus de détails.

Si la date n’a pas pu être analysée, la fonction renvoie une date non valide.

Voir également 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

Interprète « string » comme une date-heure selon le format spécifique à la locale format.

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

Certaines paramètres régionaux n’utilisent, notamment pour ShortFormat, que les deux derniers chiffres de l’année. Dans ce cas, les 100 années commençant par baseYear sont les premières prises en compte. Avant la version 6.7, le paramètre baseYear n’existait pas et l’année 1900 était toujours utilisée. C’est la valeur par défaut pour baseYear, qui sélectionne une année comprise entre cette date et 1999. Dans certains cas, d’autres champs peuvent entraîner la sélection du siècle suivant ou précédent, afin d’obtenir un résultat cohérent avec l’ensemble des champs fournis. Voir QDate::fromString() pour plus de détails.

Si la chaîne n’a pas pu être analysée, renvoie un QDateTime invalide.

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

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

Interprète string comme une date-heure au format spécifié format.

Analyse string et renvoie la date-heure qu’elle 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 par baseYear sont les premières prises en compte. Avant la version 6.7, il n’existait pas de paramètre « baseYear » et l’année 1900 était toujours utilisée. C’est la valeur par défaut pour « baseYear », qui permet de sélectionner une année comprise entre cette date et 1999. Dans certains cas, d’autres champs peuvent entraîner la sélection du siècle suivant ou précédent, afin d’obtenir un résultat cohérent avec l’ensemble des champs fournis. Voir QDate::fromString() pour plus de détails.

Si la chaîne n’a pas pu être analysée, la fonction renvoie une valeur QDateTime non valide. Si la chaîne peut être analysée et représente une date-heure non valide (par exemple, dans un intervalle sautié lors d’un changement de fuseau horaire), l’ QDateTime renvoyée représente une date-heure proche qui est valide (différant généralement de la date-heure d’origine de la largeur de l’intervalle dans les dates-heures valides, par exemple l’heure sautée lors d’un changement de fuseau horaire). En transmettant cette valeur à la fonction `fromMSecsSinceEpoch()`, on obtient une date-heure valide qui n’est pas fidèlement représentée par la chaîne analysée.

Voir également 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 la valeur de type double représentée par la chaîne localisée « s ».

Renvoie l'infini si la conversion provoque un débordement, ou 0,0 si la conversion échoue pour toute autre raison (par exemple, un sous-débordement).

Si ok n'est pas nullptr, l'échec est signalé en définissant *ok sur false, et la réussite en définissant *ok sur 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 milliers dans la locale allemande.

Cette fonction ignore les espaces en début et en fin de chaîne.

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

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

Renvoie la valeur de type double représentée par la chaîne localisée « s ».

Renvoie l'infini si la conversion provoque un débordement, ou 0,0 si la conversion échoue pour toute autre raison (par exemple, un sous-débordement).

Si ok n'est pas nullptr, l'échec est signalé en définissant *ok sur false, et la réussite en définissant *ok sur 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 milliers dans la locale allemande.

Cette fonction ignore les espaces en début et en fin de chaîne.

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

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

Renvoie la valeur de type float représentée par la chaîne localisée « s ».

Renvoie l'infini si la conversion provoque un débordement, ou 0,0 si la conversion échoue pour toute autre raison (par exemple, un sous-débordement).

Si ok n'est pas de type « nullptr », l'échec est signalé en définissant *ok sur false, et la réussite en définissant *ok sur true.

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

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

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

Renvoie la valeur flottante représentée par la chaîne localisée « s ».

Renvoie l'infini si la conversion provoque un débordement, ou 0,0 si la conversion échoue pour toute autre raison (par exemple, un sous-débordement).

Si ok n’est pas nullptr, l’échec est signalé en définissant *ok sur false, et la réussite en définissant *ok sur true.

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

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