En esta página

QLocale Class

La clase QLocale convierte números en sus representaciones como cadenas de caracteres en distintos idiomas. Más información...

Encabezado: #include <QLocale>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core

Nota: Todas las funciones de esta clase son reentrantes, con las siguientes excepciones:

Comparaciones de QLocale

CategoríaTipos comparables
igualdadQLocale

Tipos públicos

enum Country { AnyCountry, AnyTerritory, Afghanistan, AlandIslands, Albania, …, Zimbabwe }
enum CurrencySymbolFormat { CurrencyIsoCode, CurrencySymbol, CurrencyDisplayName }
enum DataSizeFormat { DataSizeIecFormat, DataSizeTraditionalFormat, DataSizeSIFormat }
flags DataSizeFormats
enum FloatingPointPrecisionOption { FloatingPointShortest }
enum FormatType { LongFormat, ShortFormat, NarrowFormat }
enum Language { AnyLanguage, C, Abkhazian, Afan, Afar, …, Zulu }
enum LanguageCodeType { ISO639Part1, ISO639Part2B, ISO639Part2T, ISO639Part3, LegacyLanguageCode, …, AnyLanguageCode }
flags LanguageCodeTypes
enum MeasurementSystem { MetricSystem, ImperialUSSystem, ImperialUKSystem, ImperialSystem }
enum NumberOption { DefaultNumberOptions, OmitGroupSeparator, RejectGroupSeparator, OmitLeadingZeroInExponent, RejectLeadingZeroInExponent, …, RejectTrailingZeroesAfterDot }
flags NumberOptions
enum QuotationStyle { StandardQuotation, AlternateQuotation }
enum Script { AnyScript, AdlamScript, AhomScript, AnatolianHieroglyphsScript, ArabicScript, …, YiScript }
(since 6.7) enum class TagSeparator { Dash, Underscore }
Territory

Funciones públicas

QLocale()
(since 6.3) QLocale(QStringView nombre)
QLocale(QLocale::Language idioma, QLocale::Territory territorio)
QLocale(QLocale::Language idioma, QLocale::Script escritura = AnyScript, QLocale::Territory territorio = AnyTerritory)
QLocale(const QString&nombre)
QLocale(const QLocale&other)
~QLocale()
QString amText() const
QString bcp47Name(QLocale::TagSeparator separador = TagSeparator::Dash) const
QLocale collation() const
QString createSeparatedList(const QStringList&list) const
QString currencySymbol(QLocale::CurrencySymbolFormat formato = CurrencySymbol) const
QString dateFormat(QLocale::FormatType formato = LongFormat) const
QString dateTimeFormat(QLocale::FormatType formato = LongFormat) const
QString dayName(int día, QLocale::FormatType tipo = LongFormat) const
QString decimalPoint() const
QString exponential() const
Qt::DayOfWeek firstDayOfWeek() const
QString formattedDataSize(qint64 bytes, int precision = 2, QLocale::DataSizeFormats format = DataSizeIecFormat) const
QString groupSeparator() const
QLocale::Language language() const
QLocale::MeasurementSystem measurementSystem() const
QString monthName(int mes, QLocale::FormatType tipo = LongFormat) const
QString name(QLocale::TagSeparator separador = TagSeparator::Underscore) const
QString nativeLanguageName() const
(since 6.2) QString nativeTerritoryName() const
QString negativeSign() const
QLocale::NumberOptions numberOptions() const
QString percent() const
QString pmText() const
QString positiveSign() const
QString quoteString(const QString&str, QLocale::QuotationStyle style = StandardQuotation) const
(since 6.0) QString quoteString(QStringView str, QLocale::QuotationStyle style = StandardQuotation) const
QLocale::Script script() const
void setNumberOptions(QLocale::NumberOptions opciones)
QString standaloneDayName(int día, QLocale::FormatType tipo = LongFormat) const
QString standaloneMonthName(int mes, QLocale::FormatType tipo = LongFormat) const
void swap(QLocale&other)
(since 6.2) QLocale::Territory territory() const
Qt::LayoutDirection textDirection() const
QString timeFormat(QLocale::FormatType formato = LongFormat) const
QString toCurrencyString(qlonglong valor, const QString&símbolo = QString()) const
QString toCurrencyString(int valor, const QString&símbolo = QString()) const
QString toCurrencyString(qulonglong valor, const QString&símbolo = QString()) const
QString toCurrencyString(short valor, const QString&símbolo = QString()) const
QString toCurrencyString(uint valor, const QString&símbolo = QString()) const
QString toCurrencyString(ushort valor, const QString&símbolo = QString()) const
QString toCurrencyString(double valor, const QString&símbolo = QString(), int precisión = -1) const
QString toCurrencyString(float i, const QString&symbol = QString(), int precision = -1) const
QDate toDate(const QString&cadena, QLocale::FormatType formato = LongFormat, int añoBase = DefaultTwoDigitBaseYear) const
QDate toDate(const QString&cadena, const QString&formato, int añoBase = DefaultTwoDigitBaseYear) const
QDate toDate(const QString&string, QLocale::FormatType format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const
QDate toDate(const QString&string, const QString&format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const
QDateTime toDateTime(const QString&string, QLocale::FormatType format = LongFormat, int baseYear = DefaultTwoDigitBaseYear) const
QDateTime toDateTime(const QString&string, const QString&format, int baseYear = DefaultTwoDigitBaseYear) const
QDateTime toDateTime(const QString&string, QLocale::FormatType format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const
QDateTime toDateTime(const QString&string, const QString&format, QCalendar cal, int baseYear = DefaultTwoDigitBaseYear) const
double toDouble(QStringView s, bool*ok = nullptr) const
double toDouble(const QString&s, bool*ok = nullptr) const
float toFloat(QStringView s, bool*ok = nullptr) const
float toFloat(const QString&s, bool*ok = nullptr) const
int toInt(QStringView s, bool*ok = nullptr) const
int toInt(const QString&s, bool*ok = nullptr) const
long toLong(QStringView s, bool*ok = nullptr) const
long toLong(const QString&s, bool*ok = nullptr) const
qlonglong toLongLong(QStringView s, bool*ok = nullptr) const
qlonglong toLongLong(const QString&s, bool*ok = nullptr) const
QString toLower(const QString&str) const
short toShort(QStringView s, bool*ok = nullptr) const
short toShort(const QString&s, bool*ok = nullptr) const
QString toString(qlonglong i) const
QString toString(QTime time, QLocale::FormatType format = LongFormat) const
QString toString(QDate fecha, QLocale::FormatType formato, QCalendar calendario) const
QString toString(const QDateTime&dateTime, QLocale::FormatType formato, QCalendar cal) const
QString toString(const QDateTime&dateTime, QStringView formato, QCalendar cal) const
QString toString(int i) const
QString toString(long i) const
QString toString(qulonglong i) const
QString toString(short i) const
QString toString(uint i) const
QString toString(ulong i) const
QString toString(ushort i) const
QString toString(QDate fecha, QLocale::FormatType formato = LongFormat) const
QString toString(QDate fecha, QStringView formato) const
QString toString(QDate fecha, const QString&formato) const
QString toString(QTime hora, QStringView formato) const
QString toString(QTime time, const QString&format) const
QString toString(const QDateTime&dateTime, QLocale::FormatType format = LongFormat) const
QString toString(const QDateTime&dateTime, QStringView format) const
QString toString(const QDateTime&dateTime, const QString&format) const
QString toString(QDate fecha, QStringView formato, QCalendar calendario) const
QString toString(double f, char formato = 'g', int precisión = 6) const
QString toString(float f, char formato = 'g', int precisión = 6) const
QString toString(int número, int anchoDeCampo, char32_t carácterDeRelleno) const
QString toString(long número, int anchoDeCampo, char32_t carácterDeRelleno) const
QString toString(qlonglong número, int anchoDelCampo, char32_t carácterDeRelleno) const
QString toString(qulonglong número, int anchoDeCampo, char32_t carácterDeRelleno) const
QString toString(short número, int anchoDeCampo, char32_t carácterDeRelleno) const
QString toString(uint número, int anchoDeCampo, char32_t carácterDeRelleno) const
QString toString(ulong número, int anchoDeCampo, char32_t carácterDeRelleno) const
QString toString(ushort número, int anchoDeCampo, char32_t carácterDeRelleno) const
QTime toTime(const QString&cadena, QLocale::FormatType formato = LongFormat) const
QTime toTime(const QString&string, const QString&format) const
uint toUInt(QStringView s, bool*ok = nullptr) const
uint toUInt(const QString&s, bool*ok = nullptr) const
ulong toULong(QStringView s, bool*ok = nullptr) const
ulong toULong(const QString&s, bool*ok = nullptr) const
qulonglong toULongLong(QStringView s, bool*ok = nullptr) const
qulonglong toULongLong(const QString&s, bool*ok = nullptr) const
ushort toUShort(QStringView s, bool*ok = nullptr) const
ushort toUShort(const QString&s, bool*ok = nullptr) const
QString toUpper(const QString&str) const
QStringList uiLanguages(QLocale::TagSeparator separator = TagSeparator::Dash) const
QList<Qt::DayOfWeek> weekdays() const
QString zeroDigit() const
QLocale &operator=(const QLocale&other)

Miembros públicos estáticos

(since 6.7) const int DefaultTwoDigitBaseYear
QLocale c()
(since 6.3) QLocale::Language codeToLanguage(QStringView languageCode, QLocale::LanguageCodeTypes codeTypes = AnyLanguageCode)
(since 6.1) QLocale::Script codeToScript(QStringView scriptCode)
(since 6.2) QLocale::Territory codeToTerritory(QStringView territoryCode)
(since 6.3) QString languageToCode(QLocale::Language language, QLocale::LanguageCodeTypes codeTypes = AnyLanguageCode)
QString languageToString(QLocale::Language language)
QList<QLocale> matchingLocales(QLocale::Language language, QLocale::Script script, QLocale::Territory territory)
(since 6.1) QString scriptToCode(QLocale::Script script)
QString scriptToString(QLocale::Script script)
void setDefault(const QLocale &locale)
QLocale system()
(since 6.2) QString territoryToCode(QLocale::Territory territory)
(since 6.2) QString territoryToString(QLocale::Territory territory)
size_t qHash(const QLocale &key, size_t seed = 0)
bool operator!=(const QLocale &lhs, const QLocale &rhs)
bool operator==(const QLocale &lhs, const QLocale &rhs)

Descripción detallada

QLocale se crea para un idioma específico, un alfabeto opcional y un territorio. Ofrece diversas funciones para dar formato a los datos como texto, localizándolos adecuadamente, y para leer datos a partir de texto localizado.

Ejemplo:

QLocale egyptian(QLocale::Arabic, QLocale::Egypt);
QString s1 = egyptian.toString(1.571429E+07, 'e');
QString s2 = egyptian.toString(10);

double d = egyptian.toDouble(s1);
int i = egyptian.toInt(s2);

QLocale admite el concepto de configuración regional predeterminada, que se determina a partir de la configuración regional del sistema al iniciar la aplicación. La configuración regional predeterminada se puede cambiar llamando al miembro estático ` setDefault()`. Establecer la configuración regional predeterminada tiene los siguientes efectos:

  • Si se crea un objeto QLocale con el constructor por defecto, utilizará la configuración de la configuración regional por defecto.
  • QString::arg() utiliza la configuración regional predeterminada para dar formato a un número cuando su especificador de posición en la cadena de formato contiene una «L», p. ej., «%L1».

El siguiente ejemplo ilustra cómo utilizar QLocale directamente:

bool ok;
double d;

QLocale::setDefault(QLocale::C);      // uses '.' as a decimal point
QLocale cLocale;                      // default-constructed C locale
d = cLocale.toDouble("1234,56", &ok); // ok == false, d == 0
d = cLocale.toDouble("1234.56", &ok); // ok == true,  d == 1234.56

QLocale::setDefault(QLocale::German); // uses ',' as a decimal point
QLocale german;                       // default-constructed German locale
d = german.toDouble("1234,56", &ok);  // ok == true,  d == 1234.56
d = german.toDouble("1234.56", &ok);  // ok == false, d == 0

QLocale::setDefault(QLocale::English);
// Default locale now uses ',' as a group separator.
QString str = QString("%1 %L2 %L3").arg(12345).arg(12345).arg(12345, 0, 16);
// str == "12345 12,345 3039"

Un método alternativo para crear un objeto QLocale consiste en especificar el nombre de la configuración regional.

QLocale korean("ko");
QLocale swiss("de_CH");

Este constructor lee el idioma, el alfabeto y/o el territorio a partir del nombre proporcionado, aceptando como separador tanto el guión bajo como el guión (e ignorando cualquier sufijo final de tipo .codeset o @variant ).

Nota: Para conocer la configuración regional de entrada de teclado actual, consulta QInputMethod::locale().

Idoneidad de los formatos

Los datos de QLocale se basan en el Common Locale Data Repository v48.2.

Estos datos son publicados por el Consorcio Unicode, cuyo objetivo es seguir los usos habituales y comunes entre los escritores de cada idioma, en cada alfabeto y en cada territorio para el que se proporcionan datos. En algunos casos, esto puede diferir de lo que se reconoce como oficial, dependiendo de la extensión con la que se siga en la práctica dicha norma oficial.

Por ejemplo, aunque la norma internacional pertinente (del BIPM) exige el uso de un espacio no separable estrecho como separador entre grupos de dígitos en los números, cuando estos se dividen para facilitar la legibilidad, y muchas jurisdicciones han adoptado esto como su norma oficial para el formato de los números, muchas configuraciones regionales tienen, de hecho, una forma tradicional de formatear los números con signos de puntuación que separan los grupos de dígitos. CLDR, y por lo tanto QLocale, sigue este uso común en lugar de la norma oficial.

Combinaciones coincidentes de idioma, alfabeto y territorio

QLocale dispone de datos, derivados de CLDR, para muchas combinaciones de idioma, alfabeto y territorio, pero no para todas. Si se crea especificando estos tres valores clave (considerando AnyLanguage, AnyScript o AnyTerritory como no especificados) y QLocale dispone de datos para la combinación dada, se utilizan dichos datos. De lo contrario, QLocale hace todo lo posible por encontrar una combinación razonable de idioma, alfabeto y territorio —para la que sí disponga de datos— que coincida con las especificadas.

El CLDR proporciona tablas de combinaciones probables, que se utilizan para completar cualquier clave o claves no especificadas; si QLocale dispone de datos para el resultado de dicha combinación probable, se utilizan esos datos. Si no se especifica ningún idioma y no se puede determinar ninguno a partir del alfabeto y el territorio, o si QLocale no dispone de datos para ese idioma, se utiliza la configuración regional «C» (al leer las claves de una cadena) o la configuración regional por defecto (en los demás casos).

Cuando QLocale no dispone de datos para las claves especificadas —habiendo completado las claves probables donde no se habían especificado—, pero sí dispone de datos para el idioma resultante, se busca una solución alternativa basándose en ignorar el territorio, el alfabeto o ambos (en ese orden). Esto da como resultado un QLocale que puede no coincidir con lo solicitado, pero que proporciona una localización tan adecuada como lo permiten los datos disponibles para las claves especificadas.

Utiliza language(), script() y territory() para determinar las claves reales utilizadas.

Véase también QString::arg() y QInputMethod::locale().

Documentación sobre los tipos de miembros

enum QLocale::Country

Este tipo enumerado se utiliza para identificar un territorio.

Un territorio concreto puede ser una provincia de un país, un país (el caso más habitual, con diferencia) o una entidad geográfica más amplia, a la que se refieren específicamente algunos detalles de localización.

ConstanteValorDescripción
QLocale::AnyCountryAnyTerritoryAlias obsoleto de AnyTerritory
QLocale::AnyTerritory (since Qt 6.2)0 
QLocale::Afghanistan1 
QLocale::AlandIslands2 
QLocale::Albania3 
QLocale::Algeria4 
QLocale::AmericanSamoa5 
QLocale::Andorra6 
QLocale::Angola7 
QLocale::Anguilla8 
QLocale::Antarctica9 
QLocale::AntiguaAndBarbuda10 
QLocale::Argentina11 
QLocale::Armenia12 
QLocale::Aruba13 
QLocale::AscensionIsland14 
QLocale::Australia15 
QLocale::Austria16 
QLocale::Azerbaijan17 
QLocale::Bahamas18 
QLocale::Bahrain19 
QLocale::Bangladesh20 
QLocale::Barbados21 
QLocale::Belarus22 
QLocale::Belgium23 
QLocale::Belize24 
QLocale::Benin25 
QLocale::Bermuda26 
QLocale::Bhutan27 
QLocale::Bolivia28 
QLocale::BonaireCaribbeanNetherlands 
QLocale::BosniaAndHerzegowinaBosniaAndHerzegovinaObsoleto, utiliza BosniaAndHerzegovina en su lugar
QLocale::BosniaAndHerzegovina (since Qt 6.0)29 
QLocale::Botswana30 
QLocale::BouvetIsland31 
QLocale::Brazil32 
QLocale::BritishIndianOceanTerritory33 
QLocale::BritishVirginIslands34 
QLocale::Brunei35 
QLocale::Bulgaria36 
QLocale::BurkinaFaso37 
QLocale::Burundi38 
QLocale::Cambodia39 
QLocale::Cameroon40 
QLocale::Canada41 
QLocale::CanaryIslands42 
QLocale::CaribbeanNetherlands44 
QLocale::CapeVerde43 
QLocale::CaymanIslands45 
QLocale::CentralAfricanRepublic46 
QLocale::CeutaAndMelilla47 
QLocale::Chad48 
QLocale::Chile49 
QLocale::China50 
QLocale::ChristmasIsland51 
QLocale::ClippertonIsland52 
QLocale::CocosIslands53 
QLocale::Colombia54 
QLocale::Comoros55 
QLocale::CongoBrazzaville56 
QLocale::CongoKinshasa57 
QLocale::CookIslands58 
QLocale::CostaRica59 
QLocale::Croatia60 
QLocale::Cuba61 
QLocale::Curacao (since Qt 6.0)62 
QLocale::CuraSaoCuracaoObsoleto, utiliza « Curacao » en su lugar
QLocale::Cyprus63 
QLocale::Czechia (since Qt 6.0)64 
QLocale::CzechRepublicCzechiaObsoleto, utiliza en su lugar Czechia
QLocale::DemocraticRepublicOfCongoCongoKinshasaObsoleto, utilice en su lugar CongoKinshasa
QLocale::DemocraticRepublicOfKoreaNorthKoreaObsoleto, utilice en su lugar NorthKorea
QLocale::Denmark65 
QLocale::DiegoGarcia66 
QLocale::Djibouti67 
QLocale::Dominica68 
QLocale::DominicanRepublic69 
QLocale::EastTimorTimorLeste 
QLocale::Ecuador70 
QLocale::Egypt71 
QLocale::ElSalvador72 
QLocale::EquatorialGuinea73 
QLocale::Eritrea74 
QLocale::Estonia75 
QLocale::Eswatini76 
QLocale::Ethiopia77 
QLocale::EuropeanUnion (since Qt 5.7)79 
QLocale::Europe (since Qt 5.12)78 
QLocale::FalklandIslands80 
QLocale::FaroeIslands81 
QLocale::Fiji82 
QLocale::Finland83 
QLocale::France84 
QLocale::FrenchGuiana85 
QLocale::FrenchPolynesia86 
QLocale::FrenchSouthernTerritories87 
QLocale::Gabon88 
QLocale::Gambia89 
QLocale::Georgia90 
QLocale::Germany91 
QLocale::Ghana92 
QLocale::Gibraltar93 
QLocale::Greece94 
QLocale::Greenland95 
QLocale::Grenada96 
QLocale::Guadeloupe97 
QLocale::Guam98 
QLocale::Guatemala99 
QLocale::Guernsey100 
QLocale::Guinea102 
QLocale::GuineaBissau101 
QLocale::Guyana103 
QLocale::Haiti104 
QLocale::HeardAndMcDonaldIslands105 
QLocale::Honduras106 
QLocale::HongKong107 
QLocale::Hungary108 
QLocale::Iceland109 
QLocale::India110 
QLocale::Indonesia111 
QLocale::Iran112 
QLocale::Iraq113 
QLocale::Ireland114 
QLocale::IsleOfMan115 
QLocale::Israel116 
QLocale::Italy117 
QLocale::IvoryCoast118 
QLocale::Jamaica119 
QLocale::Japan120 
QLocale::Jersey121 
QLocale::Jordan122 
QLocale::Kazakhstan123 
QLocale::Kenya124 
QLocale::Kiribati125 
QLocale::Kosovo (since Qt 5.2)126 
QLocale::Kuwait127 
QLocale::Kyrgyzstan128 
QLocale::Laos129 
QLocale::LatinAmerica130 
QLocale::LatinAmericaAndTheCaribbeanLatinAmericaObsoleto, utiliza « LatinAmerica » en su lugar
QLocale::Latvia131 
QLocale::Lebanon132 
QLocale::Lesotho133 
QLocale::Liberia134 
QLocale::Libya135 
QLocale::Liechtenstein136 
QLocale::Lithuania137 
QLocale::Luxembourg138 
QLocale::Macao139 
QLocale::MacauMacao 
QLocale::Macedonia140 
QLocale::Madagascar141 
QLocale::Malawi142 
QLocale::Malaysia143 
QLocale::Maldives144 
QLocale::Mali145 
QLocale::Malta146 
QLocale::MarshallIslands147 
QLocale::Martinique148 
QLocale::Mauritania149 
QLocale::Mauritius150 
QLocale::Mayotte151 
QLocale::Mexico152 
QLocale::Micronesia153 
QLocale::Moldova154 
QLocale::Monaco155 
QLocale::Mongolia156 
QLocale::Montenegro157 
QLocale::Montserrat158 
QLocale::Morocco159 
QLocale::Mozambique160 
QLocale::Myanmar161 
QLocale::Namibia162 
QLocale::NauruCountryNauruTerritoryAlias obsoleto para NauruTerritory
QLocale::NauruTerritory (since Qt 6.2)163 
QLocale::Nepal164 
QLocale::Netherlands165 
QLocale::NewCaledonia166 
QLocale::NewZealand167 
QLocale::Nicaragua168 
QLocale::Niger170 
QLocale::Nigeria169 
QLocale::Niue171 
QLocale::NorfolkIsland172 
QLocale::NorthernMarianaIslands173 
QLocale::NorthKorea174 
QLocale::Norway175 
QLocale::Oman176 
QLocale::OutlyingOceania (since Qt 5.7)177 
QLocale::Pakistan178 
QLocale::Palau179 
QLocale::PalestinianTerritories180 
QLocale::Panama181 
QLocale::PapuaNewGuinea182 
QLocale::Paraguay183 
QLocale::PeoplesRepublicOfCongoCongoBrazzavilleObsoleto, utiliza CongoBrazzaville en su lugar
QLocale::Peru184 
QLocale::Philippines185 
QLocale::Pitcairn186 
QLocale::Poland187 
QLocale::Portugal188 
QLocale::PuertoRico189 
QLocale::Qatar190 
QLocale::RepublicOfKoreaSouthKoreaObsoleto, utilice « SouthKorea » en su lugar
QLocale::Reunion191 
QLocale::Romania192 
QLocale::RussianFederationRussia 
QLocale::Russia193 
QLocale::Rwanda194 
QLocale::SaintBarthelemy195 
QLocale::SaintHelena196 
QLocale::SaintKittsAndNevis197 
QLocale::SaintLucia198 
QLocale::SaintMartin199 
QLocale::SaintPierreAndMiquelon200 
QLocale::SaintVincentAndGrenadines201 
QLocale::SaintVincentAndTheGrenadinesSaintVincentAndGrenadines 
QLocale::Samoa202 
QLocale::SanMarino203 
QLocale::SaoTomeAndPrincipe204 
QLocale::SaudiArabia205 
QLocale::Senegal206 
QLocale::Serbia207 
QLocale::Seychelles208 
QLocale::SierraLeone209 
QLocale::Singapore210 
QLocale::SintMaarten211 
QLocale::Slovakia212 
QLocale::Slovenia213 
QLocale::SolomonIslands214 
QLocale::Somalia215 
QLocale::SouthAfrica216 
QLocale::SouthGeorgiaAndSouthSandwichIslands217 
QLocale::SouthGeorgiaAndTheSouthSandwichIslandsSouthGeorgiaAndSouthSandwichIslands 
QLocale::SouthKorea218 
QLocale::SouthSudan219 
QLocale::Spain220 
QLocale::SriLanka221 
QLocale::Sudan222 
QLocale::Suriname223 
QLocale::SvalbardAndJanMayen224 
QLocale::SvalbardAndJanMayenIslandsSvalbardAndJanMayen 
QLocale::SwazilandEswatini 
QLocale::Sweden225 
QLocale::Switzerland226 
QLocale::Syria227 
QLocale::SyrianArabRepublicSyriaObsoleto, utiliza « Syria » en su lugar
QLocale::Taiwan228 
QLocale::Tajikistan229 
QLocale::Tanzania230 
QLocale::Thailand231 
QLocale::TimorLeste232 
QLocale::Togo233 
QLocale::TokelauCountryTokelauTerritoryAlias obsoleto para TokelauTerritory
QLocale::TokelauTerritory (since Qt 6.2)234 
QLocale::Tonga235 
QLocale::TrinidadAndTobago236 
QLocale::TristanDaCunha237 
QLocale::Tunisia238 
QLocale::Turkey239 
QLocale::Turkmenistan240 
QLocale::TurksAndCaicosIslands241 
QLocale::TuvaluCountryTuvaluTerritoryAlias obsoleto para TuvaluTerritory
QLocale::TuvaluTerritory (since Qt 6.2)242 
QLocale::Uganda243 
QLocale::Ukraine244 
QLocale::UnitedArabEmirates245 
QLocale::UnitedKingdom246 
QLocale::UnitedStates248 
QLocale::UnitedStatesOutlyingIslands247 
QLocale::UnitedStatesMinorOutlyingIslandsUnitedStatesOutlyingIslands 
QLocale::UnitedStatesVirginIslands249 
QLocale::Uruguay250 
QLocale::Uzbekistan251 
QLocale::Vanuatu252 
QLocale::VaticanCity253 
QLocale::VaticanCityStateVaticanCity 
QLocale::Venezuela254 
QLocale::Vietnam255 
QLocale::WallisAndFutuna256 
QLocale::WallisAndFutunaIslandsWallisAndFutuna 
QLocale::WesternSahara257 
QLocale::World (since Qt 5.12)258 
QLocale::Yemen259 
QLocale::Zambia260 
QLocale::Zimbabwe261

Nota: Utiliza el alias «Territory» para esta enumeración siempre que sea posible. La enumeración «Country» pasará a denominarse «Territory» en una versión posterior.

Véase también territory(), territoryToString(), codeToTerritory() y territoryToCode().

enum QLocale::CurrencySymbolFormat

Especifica el formato del símbolo monetario.

ConstanteValorDescripción
QLocale::CurrencyIsoCode0un código ISO-4217 de la moneda.
QLocale::CurrencySymbol1un símbolo de moneda.
QLocale::CurrencyDisplayName2un nombre de la moneda legible para el usuario.

enum QLocale::DataSizeFormat
flags QLocale::DataSizeFormats

Especifica el formato de representación de las cantidades de datos.

ConstanteValorDescripción
QLocale::DataSizeIecFormat0formato con base 1024 y prefijos IEC: KiB, MiB, GiB, ...
QLocale::DataSizeTraditionalFormatDataSizeSIQuantifiersformato con base 1024 y prefijos del SI: kB, MB, GB, ...
QLocale::DataSizeSIFormatDataSizeBase1000 | DataSizeSIQuantifiersformato con base 1000 y prefijos del SI: kB, MB, GB, ...

El tipo DataSizeFormats es una definición de tipo (typedef) para QFlags<DataSizeFormat>. Almacena una combinación OR de valores de DataSizeFormat.

Véase también formattedDataSize().

enum QLocale::FloatingPointPrecisionOption

Esta enumeración define una constante que se puede especificar como precisión en las funciones ` QString::number()`, ` QByteArray::number()` y ` QLocale::toString()` al convertir valores de tipo `float` o `double`, con el fin de expresar un número variable de dígitos como precisión.

ConstanteValorDescripción
QLocale::FloatingPointShortest-128El algoritmo de conversión intentará encontrar la representación precisa más corta para el número dado. «Precisa» significa que se obtiene exactamente el mismo número al realizar una conversión inversa sobre la representación en cadena generada. En particular, se omiten los ceros finales (de la mantisa, en formatos de exponente).

Véase también toString(), QString::number() y QByteArray::number().

enum QLocale::FormatType

Esta enumeración describe los diferentes formatos que se pueden utilizar al convertir objetos de tipo « QDate », « QTime » y « QDateTime », así como meses y días, en cadenas específicas de la configuración regional.

ConstanteValorDescripción
QLocale::LongFormat0Formato más extenso.
QLocale::ShortFormat1Formato más corto.
QLocale::NarrowFormat2Una versión especial para usar cuando el espacio es muy limitado.

Nota: « NarrowFormat » puede contener el mismo texto para diferentes meses y días. Incluso puede ser una cadena vacía si la configuración regional no admite nombres abreviados, por lo que debes evitar utilizarlo para el formato de fecha. Además, para la configuración regional del sistema, este formato es el mismo que « ShortFormat ».

Véase también dateFormat(), timeFormat(), dateTimeFormat(), monthName(), standaloneMonthName(), dayName(), standaloneDayName(), toDate(), toTime() y toDateTime().

enum QLocale::Language

Este tipo enumerado se utiliza para especificar un idioma.

ConstanteValorDescripción
QLocale::AnyLanguage0 
QLocale::C1Una configuración regional de inglés simplificada; véase QLocale::c()
QLocale::Abkhazian2 
QLocale::AfanOromoObsoleto, utilice «Oromo»
QLocale::Afar3 
QLocale::Afrikaans4 
QLocale::Aghem5 
QLocale::Akan6 
QLocale::Akkadian (since Qt 5.1)7 
QLocale::Akoose (since Qt 5.3)8 
QLocale::Albanian9 
QLocale::AmericanSignLanguage (since Qt 5.7)10 
QLocale::Amharic11 
QLocale::AncientEgyptian (since Qt 5.1)12 
QLocale::AncientGreek (since Qt 5.1)13 
QLocale::Anii (since Qt 6.7)341 
QLocale::Arabic14 
QLocale::Aragonese (since Qt 5.1)15 
QLocale::Aramaic (since Qt 5.1)16 
QLocale::Armenian17 
QLocale::Assamese18 
QLocale::Asturian19 
QLocale::Asu20 
QLocale::Atsam21 
QLocale::Avaric22 
QLocale::Avestan23 
QLocale::Aymara24 
QLocale::Azerbaijani25 
QLocale::Bafia26 
QLocale::Balinese (since Qt 5.1)27 
QLocale::Baluchi (since Qt 6.6)337 
QLocale::Bambara28 
QLocale::Bamun (since Qt 5.1)29 
QLocale::Bangla (since Qt 6.0)30 
QLocale::Basaa31 
QLocale::Bashkir32 
QLocale::Basque33 
QLocale::BatakToba (since Qt 5.1)34 
QLocale::Belarusian35 
QLocale::Bemba36 
QLocale::Bena37 
QLocale::BengaliBanglaObsoleto, por favor, utiliza «Bangla»
QLocale::Bhojpuri (since Qt 5.7)38 
QLocale::BhutaniDzongkhaObsoleto, utilice «dzongkha»
QLocale::Bislama39 
QLocale::Blin40 
QLocale::Bodo41 
QLocale::Bosnian42 
QLocale::Breton43 
QLocale::Buginese (since Qt 5.1)44 
QLocale::Bulgarian45 
QLocale::Burmese46 
QLocale::ByelorussianBelarusianObsoleto, utilice «bielorruso»
QLocale::CambodianKhmerObsoleto, utilice el jemer
QLocale::Cantonese (since Qt 5.7)47 
QLocale::Catalan48 
QLocale::Cebuano (since Qt 5.14)49 
QLocale::CentralAtlasTamazight (since Qt 6.0)50 
QLocale::CentralKurdish (since Qt 5.5)51 
QLocale::CentralMoroccoTamazightCentralAtlasTamazightObsoleto, utilice CentralAtlasTamazight
QLocale::Chakma (since Qt 5.1)52 
QLocale::Chamorro53 
QLocale::Chechen54 
QLocale::Cherokee55 
QLocale::ChewaNyanjaObsoleto, utilice Nyanja
QLocale::Chickasaw (since Qt 5.14)56 
QLocale::Chiga57 
QLocale::Chinese58(mandarín)
QLocale::Church59 
QLocale::Chuvash60 
QLocale::Colognian61 
QLocale::Coptic (since Qt 5.1)62 
QLocale::Cornish63 
QLocale::Corsican64 
QLocale::Cree65 
QLocale::Croatian66 
QLocale::Czech67 
QLocale::Danish68 
QLocale::Divehi69 
QLocale::Dogri (since Qt 5.1)70 
QLocale::Duala71 
QLocale::Dutch72 
QLocale::Dzongkha73 
QLocale::Embu74 
QLocale::English75 
QLocale::Erzya (since Qt 5.14)76 
QLocale::Esperanto77 
QLocale::Estonian78 
QLocale::Ewe79 
QLocale::Ewondo80 
QLocale::Faroese81 
QLocale::Fijian82 
QLocale::Filipino83 
QLocale::Finnish84 
QLocale::French85 
QLocale::FrisianWesternFrisianigual que en frisón occidental
QLocale::Friulian86 
QLocale::Fulah87 
QLocale::Ga89 
QLocale::Gaelic88 
QLocale::Galician90 
QLocale::Ganda91 
QLocale::Geez92 
QLocale::Georgian93 
QLocale::German94 
QLocale::Gothic (since Qt 5.1)95 
QLocale::Greek96 
QLocale::GreenlandicKalaallisutObsoleto, por favor, utiliza el kalaallisut
QLocale::Guarani97 
QLocale::Gujarati98 
QLocale::Gusii99 
QLocale::Haitian100 
QLocale::Haryanvi (since Qt 6.5)330 
QLocale::Hausa101 
QLocale::Hawaiian102 
QLocale::Hebrew103 
QLocale::Herero104 
QLocale::Hindi105 
QLocale::HiriMotu106 
QLocale::Hungarian107 
QLocale::Icelandic108 
QLocale::Ido (since Qt 5.12)109 
QLocale::Igbo110 
QLocale::InariSami (since Qt 5.5)111 
QLocale::Indonesian112 
QLocale::Ingush (since Qt 5.1)113 
QLocale::Interlingua114 
QLocale::Interlingue115 
QLocale::Inuktitut116 
QLocale::InupiakInupiaqObsoleto, por favor, utiliza «inupiaq»
QLocale::Inupiaq (since Qt 6.0)117 
QLocale::Irish118 
QLocale::Italian119 
QLocale::Japanese120 
QLocale::Javanese121 
QLocale::Jju122 
QLocale::JolaFonyi123 
QLocale::Kabuverdianu124 
QLocale::Kabyle125 
QLocale::Kaingang (since Qt 6.3)328 
QLocale::Kako126 
QLocale::Kalaallisut (since Qt 6.0)127 
QLocale::Kalenjin128 
QLocale::Kamba129 
QLocale::Kangri (since Qt 6.7)342 
QLocale::Kannada130 
QLocale::Kanuri131 
QLocale::KaraKalpak (since Qt 6.9)345 
QLocale::Kashmiri132 
QLocale::Kazakh133 
QLocale::Kenyang (since Qt 5.5)134 
QLocale::Khmer135 
QLocale::Kiche (since Qt 5.5)136 
QLocale::Kikuyu137 
QLocale::Kinyarwanda138 
QLocale::KirghizKyrgyzObsoleto, utiliza «kirguís»
QLocale::Komi139 
QLocale::Kongo140 
QLocale::Konkani141 
QLocale::Korean142 
QLocale::Koro143 
QLocale::KoyraboroSenni144 
QLocale::KoyraChiini145 
QLocale::Kpelle146 
QLocale::Kuanyama (since Qt 6.0)147 
QLocale::Kurdish148 
QLocale::KurundiRundiObsoleto, utiliza Rundi
QLocale::Kuvi (since Qt 6.8)344 
QLocale::KwanyamaKuanyamaObsoleto, utilice Kuanyama
QLocale::Kwasio149 
QLocale::Kyrgyz (since Qt 6.0)150 
QLocale::Ladin (since Qt 6.11)347 
QLocale::Lakota (since Qt 5.3)151 
QLocale::Langi152 
QLocale::Lao153 
QLocale::Latin154 
QLocale::Latvian155 
QLocale::Lezghian (since Qt 5.5)156 
QLocale::Limburgish157 
QLocale::Lingala158 
QLocale::Ligurian (since Qt 6.6)338 
QLocale::LiteraryChinese (since Qt 5.7)159 
QLocale::Lithuanian160 
QLocale::Lojban (since Qt 5.12)161 
QLocale::LowerSorbian (since Qt 5.5)162 
QLocale::LowGerman163 
QLocale::LubaKatanga164 
QLocale::LuleSami (since Qt 5.5)165 
QLocale::Luo166 
QLocale::Luxembourgish167 
QLocale::Luyia168 
QLocale::Macedonian169 
QLocale::Machame170 
QLocale::Maithili (since Qt 5.5)171 
QLocale::MakhuwaMeetto172 
QLocale::Makonde173 
QLocale::Malagasy174 
QLocale::Malay176 
QLocale::Malayalam175 
QLocale::Maltese177 
QLocale::Mandingo (since Qt 5.1)178 
QLocale::Manipuri (since Qt 5.1)179 
QLocale::Manx180 
QLocale::Maori181 
QLocale::Mapuche (since Qt 5.5)182 
QLocale::Marathi183 
QLocale::Marshallese184 
QLocale::Masai185 
QLocale::Mazanderani (since Qt 5.7)186 
QLocale::Mende (since Qt 5.5)187 
QLocale::Meru188 
QLocale::Meta189 
QLocale::Mohawk (since Qt 5.5)190 
QLocale::Moksha (since Qt 6.5)333 
QLocale::Mongolian191 
QLocale::Morisyen192 
QLocale::Mundang193 
QLocale::Muscogee (since Qt 5.14)194 
QLocale::Nama195 
QLocale::NauruLanguage196 
QLocale::NavahoNavajoObsoleto, por favor, utiliza «Navajo»
QLocale::Navajo (since Qt 6.0)197 
QLocale::Ndonga198 
QLocale::Nepali199 
QLocale::Newari (since Qt 5.7)200 
QLocale::Ngiemboon201 
QLocale::Nheengatu (since Qt 6.3)329 
QLocale::NigerianPidgin (since Qt 6.0)203 
QLocale::Ngomba202 
QLocale::Nko (since Qt 5.5)204 
QLocale::NorthernFrisian (since Qt 6.5)331 
QLocale::NorthernLuri (since Qt 5.7)205 
QLocale::NorthernSami206 
QLocale::NorthernSotho207 
QLocale::NorthNdebele208 
QLocale::NorwegianBokmal209 
QLocale::NorwegianNynorsk210 
QLocale::Nuer211 
QLocale::Nyanja212 
QLocale::Nyankole213 
QLocale::Obolo (since Qt 6.5)336 
QLocale::Occitan214 
QLocale::Odia (since Qt 6.0)215 
QLocale::Ojibwa216 
QLocale::OldIrish (since Qt 5.1)217 
QLocale::OldNorse (since Qt 5.1)218 
QLocale::OldPersian (since Qt 5.1)219 
QLocale::OriyaOdiaObsoleto, por favor, utiliza «Odia»
QLocale::Oromo220 
QLocale::Osage (since Qt 5.7)221 
QLocale::Ossetic222 
QLocale::Pahlavi (since Qt 5.1)223 
QLocale::Palauan (since Qt 5.7)224 
QLocale::Pali225 
QLocale::Papiamento (since Qt 5.7)226 
QLocale::Pashto227 
QLocale::Persian228 
QLocale::Phoenician (since Qt 5.1)229 
QLocale::Pijin (since Qt 6.5)335 
QLocale::Polish230 
QLocale::Portuguese231 
QLocale::Prussian (since Qt 5.5)232 
QLocale::Punjabi233 
QLocale::Quechua234 
QLocale::Rajasthani (since Qt 6.5)332 
QLocale::RhaetoRomanceRomanshObsoleto, por favor, utiliza el romanche
QLocale::Rohingya (since Qt 6.6)339 
QLocale::Romanian235 
QLocale::Romansh236 
QLocale::Rombo237 
QLocale::Rundi238 
QLocale::Russian239 
QLocale::Rwa240 
QLocale::Saho241 
QLocale::Sakha242 
QLocale::Samburu243 
QLocale::Samoan244 
QLocale::Sango245 
QLocale::Sangu246 
QLocale::Sanskrit247 
QLocale::Santali (since Qt 5.1)248 
QLocale::Sardinian249 
QLocale::Saurashtra (since Qt 5.1)250 
QLocale::Sena251 
QLocale::Serbian252 
QLocale::Shambala253 
QLocale::Shan (since Qt 6.11)348 
QLocale::Shona254 
QLocale::SichuanYi255 
QLocale::Sicilian (since Qt 5.12)256 
QLocale::Sidamo257 
QLocale::Silesian (since Qt 5.14)258 
QLocale::Sindhi259 
QLocale::Sinhala260 
QLocale::SkoltSami (since Qt 5.5)261 
QLocale::Slovak262 
QLocale::Slovenian263 
QLocale::Soga264 
QLocale::Somali265 
QLocale::SouthernKurdish (since Qt 5.12)266 
QLocale::SouthernSami (since Qt 5.5)267 
QLocale::SouthernSotho268 
QLocale::SouthNdebele269 
QLocale::Spanish270 
QLocale::StandardMoroccanTamazight (since Qt 5.3)271 
QLocale::Sundanese272 
QLocale::Swahili273 
QLocale::SwampyCree (since Qt 6.9)346 
QLocale::Swati274 
QLocale::Swedish275 
QLocale::SwissGerman276 
QLocale::Syriac277 
QLocale::Tachelhit278 
QLocale::Tahitian279 
QLocale::TaiDam (since Qt 5.1)280 
QLocale::Taita281 
QLocale::Tajik282 
QLocale::Tamil283 
QLocale::Taroko284 
QLocale::Tasawaq285 
QLocale::Tatar286 
QLocale::Telugu287 
QLocale::Teso288 
QLocale::Thai289 
QLocale::Tibetan290 
QLocale::Tigre291 
QLocale::Tigrinya292 
QLocale::TokelauLanguage (since Qt 5.7)293 
QLocale::TokiPona (since Qt 6.5)334 
QLocale::TokPisin (since Qt 5.7)294 
QLocale::Tongan295 
QLocale::Torwali (since Qt 6.6)340 
QLocale::Tsonga296 
QLocale::Tswana297 
QLocale::Turkish298 
QLocale::Turkmen299 
QLocale::TuvaluLanguage (since Qt 5.7)300 
QLocale::Tyap301 
QLocale::Ugaritic (since Qt 5.1)302 
QLocale::UighurUyghurObsoleto, utilice «uigur»
QLocale::UigurUyghurObsoleto, utilice «uigur»
QLocale::Ukrainian303 
QLocale::UpperSorbian (since Qt 5.5)304 
QLocale::Urdu305 
QLocale::Uyghur (since Qt 6.0)306 
QLocale::Uzbek307 
QLocale::Vai308 
QLocale::Venda309 
QLocale::Venetian (since Qt 6.7)343 
QLocale::Vietnamese310 
QLocale::Volapuk311 
QLocale::Vunjo312 
QLocale::WalamoWolayttaObsoleto, por favor, utiliza Wolaytta
QLocale::Walloon313 
QLocale::Walser314 
QLocale::Warlpiri (since Qt 5.5)315 
QLocale::Welsh316 
QLocale::WesternBalochi (since Qt 5.12)317 
QLocale::WesternFrisian318igual que el frisón
QLocale::Wolaytta (since Qt 6.0)319 
QLocale::Wolof320 
QLocale::Xhosa321 
QLocale::Yangben322 
QLocale::Yiddish323 
QLocale::Yoruba324 
QLocale::Zarma325 
QLocale::Zhuang326 
QLocale::Zulu327 

Véase también language() y languageToString().

enum QLocale::LanguageCodeType
flags QLocale::LanguageCodeTypes

Esta enumeración define los tipos de códigos de idioma que pueden utilizarse para restringir el conjunto de códigos de idioma que tienen en cuenta codeToLanguage y languageToCode.

ConstanteValorDescripción
QLocale::ISO639Part11 << 0Código alfa-2 de la norma ISO 639, parte 1.
QLocale::ISO639Part2B1 << 1Código alfa-3 bibliográfico de la norma ISO 639, parte 2.
QLocale::ISO639Part2T1 << 2Código alfa-3 terminológico de la Parte 2 de la norma ISO 639.
QLocale::ISO639Part31 << 3Código alfa-3 de la parte 3 de la norma ISO 639.
QLocale::LegacyLanguageCode1 << 15Códigos que no forman parte del conjunto anterior, pero que Qt admitía en el pasado. Este valor solo puede utilizarse con la función ` codeToLanguage()`. Se ignora cuando se pasa a la función ` languageToCode()`.
QLocale::ISO639Part2ISO639Part2B | ISO639Part2TCualquier código ISO 639, Parte 2.
QLocale::ISO639Alpha2ISO639Part1Cualquier código ISO-639 de dos letras.
QLocale::ISO639Alpha3ISO639Part2 | ISO639Part3Cualquier código ISO 639 de tres letras.
QLocale::ISO639ISO639Alpha2 | ISO639Alpha3Cualquier código ISO 639.
QLocale::AnyLanguageCode-1Especifica que se puede utilizar cualquier código.

El tipo LanguageCodeTypes es una definición de tipo (typedef) para QFlags<LanguageCodeType>. Almacena una combinación OR de valores de LanguageCodeType.

enum QLocale::MeasurementSystem

Esta enumeración define qué unidades se utilizan para la medición.

ConstanteValorDescripción
QLocale::MetricSystem0Este valor indica unidades métricas, como metros, centímetros y milímetros, basadas en el Sistema Internacional (SI).
QLocale::ImperialUSSystem1Este valor indica unidades imperiales, como pulgadas y millas, tal y como se utilizan en Estados Unidos.
QLocale::ImperialUKSystem2Este valor indica unidades imperiales, como pulgadas y millas, tal y como se utilizan en el Reino Unido.
QLocale::ImperialSystemImperialUSSystemSe proporciona por motivos de compatibilidad. Equivalente a «ImperialUSSystem».

enum QLocale::NumberOption
flags QLocale::NumberOptions

Esta enumeración define un conjunto de opciones para las conversiones de número a cadena y de cadena a número. Se pueden recuperar con ` numberOptions()` y establecer con ` setNumberOptions()`.

ConstanteValorDescripción
QLocale::DefaultNumberOptions0x0Esta opción representa el comportamiento por defecto para todas las configuraciones regionales excepto la de C: con separadores de grupos, con un cero inicial en los exponentes de un solo dígito y sin ceros finales al final de la parte fraccionaria (cuando existe).
QLocale::OmitGroupSeparator0x01Si se activa esta opción, las funciones de conversión de número a cadena no dividirán los dígitos en grupos. La configuración regional C establece esta opción de forma predeterminada. El valor predeterminado para todas las demás configuraciones regionales es dividir los dígitos en grupos, en la parte entera de un número, con separadores de grupo.
QLocale::RejectGroupSeparator0x02Si se activa esta opción, las funciones de conversión de cadena a número fallarán si encuentran separadores de grupo en su entrada. El valor por defecto es aceptar números que contengan separadores de grupo colocados correctamente.
QLocale::OmitLeadingZeroInExponent0x04Si se activa esta opción, las funciones de conversión de números a cadenas no rellenarán los exponentes con ceros al mostrar números de coma flotante en notación científica. Por defecto, se añade un cero inicial a los exponentes de un solo dígito.
QLocale::RejectLeadingZeroInExponent0x08Si se activa esta opción, las funciones de conversión de cadena a número fallarán si encuentran un exponente rellenado con ceros al analizar un número de coma flotante en notación científica. Por defecto, se acepta dicho relleno.
QLocale::IncludeTrailingZeroesAfterDot0x10Si se activa esta opción, las funciones de conversión de números a cadenas rellenarán los números con ceros hasta la precisión solicitada en el modo «g» o «más conciso». Por defecto, se omiten los ceros finales, lo que puede dejar menos dígitos en la parte fraccionaria que la precisión solicitada.
QLocale::RejectTrailingZeroesAfterDot0x20Si se activa esta opción, las funciones de conversión de cadena a número fallarán si encuentran ceros finales al final de la parte fraccionaria al analizar un número en representación científica o decimal. Por defecto, se aceptan los ceros finales.

El tipo `NumberOptions` es una definición de tipo (`typedef`) para ` QFlags<NumberOption>`. Almacena una combinación OR de valores de `NumberOption`.

Véase también setNumberOptions(), numberOptions() y FloatingPointPrecisionOption.

enum QLocale::QuotationStyle

Esta enumeración define un conjunto de estilos posibles para las comillas específicas de cada configuración regional.

ConstanteValorDescripción
QLocale::StandardQuotation0Si se activa esta opción, se utilizarán las comillas estándar para encerrar las cadenas.
QLocale::AlternateQuotation1Si se activa esta opción, se utilizarán las comillas alternativas para encerrar las cadenas.

Véase también quoteString().

enum QLocale::Script

Este tipo enumerado se utiliza para especificar un script.

ConstanteValorDescripción
QLocale::AnyScript0 
QLocale::AdlamScript (since Qt 5.7)1 
QLocale::AhomScript (since Qt 5.7)2 
QLocale::AnatolianHieroglyphsScript (since Qt 5.7)3 
QLocale::ArabicScript4 
QLocale::ArmenianScript5 
QLocale::AvestanScript (since Qt 5.1)6 
QLocale::BalineseScript (since Qt 5.1)7 
QLocale::BamumScript (since Qt 5.1)8 
QLocale::BanglaScript (since Qt 6.0)9 
QLocale::BassaVahScript (since Qt 5.5)10 
QLocale::BatakScript (since Qt 5.1)11 
QLocale::BengaliScriptBanglaScriptObsoleto, por favor, utiliza BanglaScript
QLocale::BhaiksukiScript (since Qt 5.7)12 
QLocale::BopomofoScript (since Qt 5.1)13 
QLocale::BrahmiScript (since Qt 5.1)14 
QLocale::BrailleScript (since Qt 5.1)15 
QLocale::BugineseScript (since Qt 5.1)16 
QLocale::BuhidScript (since Qt 5.1)17 
QLocale::CanadianAboriginalScript (since Qt 5.1)18 
QLocale::CarianScript (since Qt 5.1)19 
QLocale::CaucasianAlbanianScript (since Qt 5.5)20 
QLocale::ChakmaScript (since Qt 5.1)21 
QLocale::ChamScript (since Qt 5.1)22 
QLocale::CherokeeScript23 
QLocale::CopticScript (since Qt 5.1)24 
QLocale::CuneiformScript (since Qt 5.1)25 
QLocale::CypriotScript (since Qt 5.1)26 
QLocale::CyrillicScript27 
QLocale::DeseretScript (since Qt 5.1)28 
QLocale::DevanagariScript29 
QLocale::DuployanScript (since Qt 5.5)30 
QLocale::EgyptianHieroglyphsScript (since Qt 5.1)31 
QLocale::ElbasanScript (since Qt 5.5)32 
QLocale::EthiopicScript33 
QLocale::FraserScript (since Qt 5.1)34 
QLocale::GeorgianScript35 
QLocale::GlagoliticScript (since Qt 5.1)36 
QLocale::GothicScript (since Qt 5.1)37 
QLocale::GranthaScript (since Qt 5.5)38 
QLocale::GreekScript39 
QLocale::GujaratiScript40 
QLocale::GurmukhiScript41 
QLocale::HangulScript (since Qt 5.1)42 
QLocale::HanifiScript (since Qt 6.6)142 
QLocale::HanScript (since Qt 5.1)43 
QLocale::HanunooScript (since Qt 5.1)44 
QLocale::HanWithBopomofoScript (since Qt 5.7)45 
QLocale::HatranScript (since Qt 5.7)46 
QLocale::HebrewScript47 
QLocale::HiraganaScript (since Qt 5.1)48 
QLocale::ImperialAramaicScript (since Qt 5.1)49 
QLocale::InscriptionalPahlaviScript (since Qt 5.1)50 
QLocale::InscriptionalParthianScript (since Qt 5.1)51 
QLocale::JamoScript (since Qt 5.7)52 
QLocale::JapaneseScript53 
QLocale::JavaneseScript (since Qt 5.1)54 
QLocale::KaithiScript (since Qt 5.1)55 
QLocale::KannadaScript56 
QLocale::KatakanaScript (since Qt 5.1)57 
QLocale::KayahLiScript (since Qt 5.1)58 
QLocale::KharoshthiScript (since Qt 5.1)59 
QLocale::KhmerScript (since Qt 5.1)60 
QLocale::KhojkiScript (since Qt 5.5)61 
QLocale::KhudawadiScript (since Qt 5.5)62 
QLocale::KoreanScript63 
QLocale::LannaScript (since Qt 5.1)64 
QLocale::LaoScript65 
QLocale::LatinScript66 
QLocale::LepchaScript (since Qt 5.1)67 
QLocale::LimbuScript (since Qt 5.1)68 
QLocale::LinearAScript (since Qt 5.5)69 
QLocale::LinearBScript (since Qt 5.1)70 
QLocale::LycianScript (since Qt 5.1)71 
QLocale::LydianScript (since Qt 5.1)72 
QLocale::MahajaniScript (since Qt 5.5)73 
QLocale::MalayalamScript74 
QLocale::MandaeanScript (since Qt 5.1)75 
QLocale::ManichaeanScript (since Qt 5.5)76 
QLocale::MarchenScript (since Qt 5.7)77 
QLocale::MeiteiMayekScript (since Qt 5.1)78 
QLocale::MendeScript (since Qt 6.0)79 
QLocale::MendeKikakuiScriptMendeScriptObsoleto, utiliza MendeScript
QLocale::MeroiticCursiveScript (since Qt 5.1)80 
QLocale::MeroiticScript (since Qt 5.1)81 
QLocale::ModiScript (since Qt 5.5)82 
QLocale::MongolianScript83 
QLocale::MroScript (since Qt 5.5)84 
QLocale::MultaniScript (since Qt 5.7)85 
QLocale::MyanmarScript86 
QLocale::NabataeanScript (since Qt 5.5)87 
QLocale::NewaScript (since Qt 5.7)88 
QLocale::NewTaiLueScript (since Qt 5.1)89 
QLocale::NkoScript (since Qt 5.1)90 
QLocale::OghamScript (since Qt 5.1)92 
QLocale::OlChikiScript (since Qt 5.1)93 
QLocale::OldHungarianScript (since Qt 5.7)94 
QLocale::OldItalicScript (since Qt 5.1)95 
QLocale::OldNorthArabianScript (since Qt 5.5)96 
QLocale::OldPermicScript (since Qt 5.5)97 
QLocale::OldPersianScript (since Qt 5.1)98 
QLocale::OldSouthArabianScript (since Qt 5.1)99 
QLocale::OdiaScript (since Qt 6.0)91 
QLocale::OriyaScriptOdiaScriptObsoleto, utiliza OdiaScript
QLocale::OrkhonScript (since Qt 5.1)100 
QLocale::OsageScript (since Qt 5.7)101 
QLocale::OsmanyaScript (since Qt 5.1)102 
QLocale::PahawhHmongScript (since Qt 5.5)103 
QLocale::PalmyreneScript (since Qt 5.5)104 
QLocale::PauCinHauScript (since Qt 5.5)105 
QLocale::PhagsPaScript (since Qt 5.1)106 
QLocale::PhoenicianScript (since Qt 5.1)107 
QLocale::PollardPhoneticScript (since Qt 5.1)108 
QLocale::PsalterPahlaviScript (since Qt 5.5)109 
QLocale::RejangScript (since Qt 5.1)110 
QLocale::RunicScript (since Qt 5.1)111 
QLocale::SamaritanScript (since Qt 5.1)112 
QLocale::SaurashtraScript (since Qt 5.1)113 
QLocale::SharadaScript (since Qt 5.1)114 
QLocale::ShavianScript (since Qt 5.1)115 
QLocale::SiddhamScript (since Qt 5.5)116 
QLocale::SignWritingScript (since Qt 5.7)117 
QLocale::SimplifiedChineseScriptSimplifiedHanScriptigual que la escritura Han simplificada
QLocale::SimplifiedHanScript118igual que «Escritura china simplificada»
QLocale::SinhalaScript119 
QLocale::SoraSompengScript (since Qt 5.1)120 
QLocale::SundaneseScript (since Qt 5.1)121 
QLocale::SylotiNagriScript (since Qt 5.1)122 
QLocale::SyriacScript123 
QLocale::TagalogScript (since Qt 5.1)124 
QLocale::TagbanwaScript (since Qt 5.1)125 
QLocale::TaiLeScript (since Qt 5.1)126 
QLocale::TaiVietScript (since Qt 5.1)127 
QLocale::TakriScript (since Qt 5.1)128 
QLocale::TamilScript129 
QLocale::TangutScript (since Qt 5.7)130 
QLocale::TeluguScript131 
QLocale::ThaanaScript132 
QLocale::ThaiScript133 
QLocale::TibetanScript134 
QLocale::TifinaghScript135 
QLocale::TirhutaScript (since Qt 5.5)136 
QLocale::TraditionalChineseScriptTraditionalHanScriptigual que la escritura han tradicional
QLocale::TraditionalHanScript137igual que la escritura tradicional china
QLocale::UgariticScript (since Qt 5.1)138 
QLocale::VaiScript139 
QLocale::VarangKshitiScript (since Qt 5.5)140 
QLocale::YiScript141 

Véase también script(), scriptToString() y languageToString().

[since 6.7] enum class QLocale::TagSeparator

Indica cómo se combinan los elementos que componen un identificador de configuración regional.

Un identificador de configuración regional puede estar compuesto por varias etiquetas, que indican el idioma, el alfabeto y el territorio (además de, posiblemente, otros detalles), unidas entre sí para formar el identificador. Diversas normas y formas convencionales utilizan bien un guión (el carácter Unicode HYPHEN-MINUS, U+002D) o bien un guión bajo (LOW LINE, U+005F). Por lo tanto, los distintos clientes de QLocale pueden necesitar uno u otro.

ConstanteValorDescripción
QLocale::TagSeparator::Dash'-'Utilice '-', el carácter de guión o de separación.
QLocale::TagSeparator::Underscore'_'Utiliza '_', el carácter de guión bajo.

Nota: Aunque el guión y el guión bajo son los únicos separadores utilizados en los estándares públicos (a fecha de 2023), es posible convertir cualquier carácter ASCII a este tipo si se necesita un separador ASCII no estándar. No se admite la conversión de un carácter no ASCII (con un valor decimal superior a 127): dichos valores se reservan para su uso futuro como miembros de una enumeración, en caso de que algún estándar público utilice alguna vez un separador no ASCII. Por supuesto, es posible utilizar ` QString::replace()` para sustituir el separador utilizado por una función que admita un parámetro de este tipo por un carácter o una cadena Unicode arbitrarios.

Esta enumeración se introdujo en Qt 6.7.

[alias] QLocale::Territory

Este tipo de enumeración es un alias de « Country », cuyo nombre se cambiará a «Territory» en una futura versión.

Véase también territory() y territoryToString().

Documentación de las funciones de miembro

QLocale::QLocale()

Crea un objeto QLocale inicializado con la configuración regional predeterminada.

Si no se ha establecido ninguna configuración regional predeterminada mediante setDefault(), esta configuración regional será la misma que la devuelta por system().

Véanse también setDefault() y system().

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

Crea un objeto QLocale con el name especificado.

El nombre tiene el formato «idioma[_alfabeto][_territorio][.juego de caracteres][@modificador]» o «C», donde:

  • «language» es un código de idioma ISO 639 de dos letras en minúsculas (también se reconocen algunos códigos de tres letras),
  • script es un código de escritura ISO 15924 de cuatro letras en mayúsculas,
  • territorio es un código de territorio ISO 3166 de dos letras en mayúsculas (también se reconocen algunos códigos numéricos), y
  • codeset y modifier se ignoran.

El separador puede ser un guión bajo '_' (U+005F, «línea baja») o un guión '-' (U+002D, «guión-menos»). Si QLocale no dispone de datos para la combinación especificada de idioma, alfabeto y territorio, utilizará en su lugar la coincidencia más adecuada que pueda encontrar. Si la cadena incumple el formato de configuración regional, o si no se encuentran datos adecuados para las claves especificadas, se utilizará en su lugar la configuración regional «C».

Este constructor es mucho más lento que QLocale(Idioma, Escritura, Territorio) o QLocale(Idioma, Territorio).

Esta función se introdujo en Qt 6.3.

Véase también bcp47Name() y Matching combinations of language, script and territory.

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

Crea un objeto QLocale para los valores especificados de « language » y « territory ».

Si hay más de un alfabeto en uso para esta combinación, se seleccionará uno probable. Si QLocale no dispone de datos para el language especificado, se utilizará la configuración regional predeterminada. Si QLocale no dispone de datos para la combinación especificada de language y territory, se podrá utilizar un territorio alternativo en su lugar.

Véase también setDefault() y Matching combinations of language, script and territory.

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

Crea un objeto QLocale para los valores especificados de language, script y territory.

Si QLocale no dispone de datos para la combinación dada, buscará los datos que mejor se ajusten a ella. Recurrirá a la configuración regional predeterminada si

  • language AnyLanguage y no se puede deducir ningún idioma a partir de y script territory
  • QLocale no tiene datos para el idioma, ya sea el indicado como language o el deducido como se ha indicado anteriormente.

Véase también setDefault() y Matching combinations of language, script and territory.

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

Esta es una función sobrecargada.

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

Crea un objeto QLocale como copia de other.

[noexcept] QLocale::~QLocale()

Destructor

QString QLocale::amText() const

Devuelve el nombre traducido del sufijo «AM» para las horas especificadas según las convenciones del reloj de 12 horas.

Véase también pmText().

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

Devuelve los nombres de los campos BCP47 separados por guiones.

Esto combina tantos campos de idioma, alfabeto y territorio (y posiblemente otros campos BCP47) de esta configuración regional como sean necesarios para identificarla de forma unívoca. Ten en cuenta que se pueden omitir campos si las especificaciones del Consorcio Unicode ( Likely Subtag Rules ) dan a entender los campos omitidos a partir de los que se conservan. Consulte name() para saber cómo construir una cadena a partir de campos individuales, en caso de que se necesite algún otro formato.

A diferencia de uiLanguages(), el valor devuelto por bcp47Name() representa el nombre de configuración regional de los datos de QLocale; no tiene por qué ser el idioma en el que deba estar la interfaz de usuario.

Esta función intenta ajustar el nombre de la configuración regional a la «Best Common Practice 47» (BCP47) de la IETF, definida por el RFC 5646. Desde Qt 6.7, admite un parámetro opcional separator que puede utilizarse para anular el uso especificado por la BCP47 de un guion para separar las etiquetas. Sin embargo, para su uso en protocolos definidos por la IETF, se debe mantener el valor por defecto, ` QLocale::TagSeparator::Dash`.

Véanse también name(), language(), territory(), script() y uiLanguages().

[static noexcept] QLocale QLocale::c()

Devuelve un objeto ` QLocale ` inicializado con la configuración regional «C».

Esta configuración regional se basa en en_US, pero presenta algunas peculiaridades propias, como el formato numérico simplificado y su propio formato de fecha. Implementa los estándares POSIX que describen el comportamiento de las funciones de la biblioteca estándar del lenguaje de programación «C».

Entre otras cosas, esto significa que su orden de colación se basa en los valores ASCII de las letras, de modo que (en la ordenación que distingue entre mayúsculas y minúsculas) todas las letras mayúsculas se ordenan antes que cualquier letra minúscula (en lugar de que las formas mayúsculas y minúsculas de cada letra se ordenen una junto a otra, antes que las dos formas de la siguiente letra).

Véase también system().

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

Devuelve la enumeración « QLocale::Language » correspondiente al código de idioma de dos o tres letras « languageCode », tal y como se define en las normas ISO 639.

Si se especifica, codeTypes selecciona qué conjunto de códigos se debe tener en cuenta para la conversión. Por defecto, se tienen en cuenta todos los códigos conocidos por Qt. Los códigos se comparan en el siguiente orden: ISO639Part1, ISO639Part2B, ISO639Part2T, ISO639Part3, LegacyLanguageCode.

Si el código no es válido o no se conoce, se devuelve QLocale::AnyLanguage.

Esta función se introdujo en Qt 6.3.

Véase también languageToCode(), codeToTerritory() y codeToScript().

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

Devuelve la enumeración « QLocale::Script » correspondiente al alfabeto de cuatro letras « scriptCode », tal y como se define en la norma ISO 15924.

Si el código no es válido o se desconoce, se devuelve QLocale::AnyScript.

Esta función se introdujo en Qt 6.1.

Véase también scriptToCode(), codeToLanguage() y codeToTerritory().

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

Devuelve la enumeración « QLocale::Territory » correspondiente al código de dos letras o tres dígitos « territoryCode », tal y como se define en la norma ISO 3166.

Si el código no es válido o se desconoce, se devuelve QLocale::AnyTerritory.

Esta función se introdujo en Qt 6.2.

Véase también territoryToCode(), codeToLanguage() y codeToScript().

QLocale QLocale::collation() const

Devuelve la configuración regional que se utilizará para la ordenación.

El resultado suele ser esta configuración regional; sin embargo, la configuración regional del sistema (que suele ser la predeterminada) devolverá la configuración regional de clasificación del sistema. El resultado es adecuado para pasarlo al constructor de ` QCollator`.

Véase también QCollator.

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

Devuelve una cadena que representa la unión de una lista de cadenas dada ( list ) con un separador definido por la configuración regional.

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

Devuelve un símbolo de moneda según la norma « format ».

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

Devuelve el formato de fecha utilizado para la configuración regional actual.

Si format es LongFormat, el formato será detallado; en caso contrario, será breve. Por ejemplo, LongFormat para la configuración regional en_US es dddd, MMMM d, yyyy, y ShortFormat es M/d/yy.

Véase también QDate::toString() y QDate::fromString().

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

Devuelve el formato de fecha y hora utilizado para la configuración regional actual.

Si format es LongFormat, el formato será detallado; en caso contrario, será breve. Por ejemplo, LongFormat para la configuración regional en_US es dddd, MMMM d, yyyy h:mm:ss AP t, y ShortFormat es M/d/yy h:mm AP.

Véase también QDateTime::toString() y QDateTime::fromString().

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

Devuelve el nombre localizado de « day » (donde 1 representa el lunes, 2 representa el martes y así sucesivamente), en el formato especificado por « type ».

Por ejemplo, si la configuración regional es « en_US » y day es 1, LongFormat devolverá Monday, ShortFormat Mon y NarrowFormat M .

Véase también monthName() y standaloneDayName().

QString QLocale::decimalPoint() const

Devuelve el separador de la parte fraccionaria para esta configuración regional.

Se trata del símbolo que separa la parte entera de la parte fraccionaria en la representación de un número que tiene una parte fraccionaria. Se suele denominar «carácter del punto decimal», aunque, en muchas configuraciones regionales, no se trata de un «punto» (ni de un símbolo similar). A partir de Qt 6.0, se devuelve como una cadena de caracteres en caso de que alguna configuración regional necesite más de un punto de código UTF-16 para representar su separador.

Véase también groupSeparator() y toString().

QString QLocale::exponential() const

Devuelve el separador de exponentes para esta configuración regional.

Se trata de un token que se utiliza para separar la mantisa del exponente en algunas representaciones numéricas de coma flotante. A partir de Qt 6.0, se devuelve como una cadena de caracteres porque, en algunas configuraciones regionales, no es un único carácter; por ejemplo, puede consistir en un signo de multiplicación y una representación del operador «diez elevado a».

Véase también toString(double, char, int).

Qt::DayOfWeek QLocale::firstDayOfWeek() const

Devuelve el primer día de la semana según la configuración regional actual.

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

Convierte un tamaño en bytes en una cadena localizada legible para el usuario, compuesta por un número y una unidad cuantificada. El cuantificador se elige de tal forma que el número sea al menos uno y lo más pequeño posible. Por ejemplo, si bytes es 16384, precision es 2 y format es DataSizeIecFormat (el valor por defecto), esta función devuelve «16,00 KiB»; para 1330409069609 bytes devuelve «1,21 GiB»; y así sucesivamente. Si format es DataSizeIecFormat o DataSizeTraditionalFormat, el número de bytes dado se divide por una potencia de 1024, y el resultado es menor que 1024; para DataSizeSIFormat, se divide por una potencia de 1000, y el resultado es menor que 1000. DataSizeIecFormat utiliza los nuevos cuantificadores de la norma IEC Ki, Mi, etc., mientras que DataSizeSIFormat utiliza los antiguos cuantificadores del SI k, M, etc., y DataSizeTraditionalFormat hace un uso indebido de ellos.

QString QLocale::groupSeparator() const

Devuelve el separador de agrupación de dígitos para esta configuración regional.

Se trata de un token que se utiliza para dividir secuencias largas de dígitos, en la representación de un número, con el fin de facilitar su lectura. En algunas configuraciones regionales puede estar vacío, lo que indica que los dígitos no deben dividirse en grupos de esta manera. En otras, puede ser un carácter de espaciado. Desde Qt 6.0 se devuelve como una cadena de caracteres, por si alguna configuración regional necesitara más de un punto de código UTF-16 para representar su separador.

Véase también decimalPoint() y toString().

QLocale::Language QLocale::language() const

Devuelve el idioma de esta configuración regional.

Véanse también script(), territory(), languageToString() y bcp47Name().

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

Devuelve el código de idioma de dos o tres letras para language, tal y como se define en las normas ISO 639.

Si se especifica, codeTypes selecciona qué conjunto de códigos se debe tener en cuenta. Se devuelve el primer código del conjunto definido para language. De lo contrario, se tienen en cuenta todos los códigos ISO-639. Los códigos se tienen en cuenta en el siguiente orden: ISO639Part1, ISO639Part2B, ISO639Part2T, ISO639Part3. Esta función ignora LegacyLanguageCode.

Nota: Para QLocale::C, la función devuelve "C". Para QLocale::AnyLanguage, se devuelve una cadena vacía. Si el idioma no tiene ningún código en ninguno de los conjuntos de códigos seleccionados, se devuelve una cadena vacía.

Esta función se introdujo en Qt 6.3.

Véase también codeToLanguage(), language(), name(), bcp47Name(), territoryToCode() y scriptToCode().

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

Devuelve un objeto ` QString ` que contiene el nombre de ` language`.

Véase también territoryToString(), scriptToString() y bcp47Name().

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

Devuelve una lista de objetos de configuración regional válidos que coinciden con los valores proporcionados en language, script y territory.

Obtener una lista de todas las configuraciones regionales: QList<QLocale> allLocales = QLocale::matchingLocales(QLocale::AnyLanguage, QLocale::AnyScript, QLocale::AnyTerritory);

Obtener una lista de configuraciones regionales adecuadas para Rusia: QList<QLocale> locales = QLocale::matchingLocales(QLocale::AnyLanguage, QLocale::AnyScript, QLocale::Russia);

QLocale::MeasurementSystem QLocale::measurementSystem() const

Devuelve el sistema de medidas correspondiente a la configuración regional.

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

Devuelve el nombre localizado de month, en el formato especificado por type.

Por ejemplo, si la configuración regional es en_US y month es 1, LongFormat devolverá January. ShortFormat Jan , y NarrowFormat J .

Véase también dayName() y standaloneMonthName().

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

El nombre abreviado de esta configuración regional.

Devuelve el idioma y el territorio de esta configuración regional como una cadena con el formato «idioma_territorio», donde «idioma» es un código de idioma ISO 639 de dos letras en minúsculas, y «territorio» es un código de territorio ISO 3166 de dos o tres letras en mayúsculas. Si la configuración regional no tiene un territorio especificado, solo se devuelve el nombre del idioma. Desde Qt 6.7 se puede proporcionar un parámetro opcional ` separator ` para anular el carácter de guión bajo predeterminado que separa las dos etiquetas.

Aunque el objeto ` QLocale ` se haya creado con un script explícito, `name()` no lo incluirá por motivos de compatibilidad. Utiliza ` bcp47Name()` en su lugar si necesitas un nombre completo de configuración regional, o construye la cadena con la que deseas identificar una configuración regional a partir de las devueltas al pasar su ` language()` a ` languageToCode()` y de forma similar para el script y el territorio.

Véase también QLocale(), language(), script(), territory(), bcp47Name() y uiLanguages().

QString QLocale::nativeLanguageName() const

Devuelve un nombre nativo en el idioma correspondiente a la configuración regional. Por ejemplo, «Schweizer Hochdeutsch» para la configuración regional del alemán suizo.

Véase también nativeTerritoryName() y languageToString().

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

Devuelve el nombre nativo del territorio correspondiente a la configuración regional. Por ejemplo, «España» para la configuración regional «Español/España».

Esta función se introdujo en Qt 6.2.

Véase también nativeLanguageName() y territoryToString().

QString QLocale::negativeSign() const

Devuelve el indicador del signo negativo de esta configuración regional.

Se trata de un token que se supone que se utiliza como prefijo de un número para indicar que es negativo. Desde Qt 6.0 se devuelve como una cadena porque, en algunas configuraciones regionales, no es un solo carácter; por ejemplo, porque incluye un carácter de control de la dirección del texto.

Véase también positiveSign() y toString().

QLocale::NumberOptions QLocale::numberOptions() const

Devuelve las opciones relacionadas con las conversiones numéricas para esta instancia de ` QLocale `.

Por defecto, no hay ninguna opción configurada para las configuraciones regionales estándar, salvo para la configuración regional «C», que tiene OmitGroupSeparator activado por defecto.

Véase también setNumberOptions(), toString(), groupSeparator() y FloatingPointPrecisionOption.

QString QLocale::percent() const

Devuelve el símbolo de porcentaje de esta configuración regional.

Se trata de un token que se supone que se añade a un número para indicar un porcentaje. Desde Qt 6.0 se devuelve como una cadena porque, en algunas configuraciones regionales, no es un único carácter; por ejemplo, porque incluye un carácter de control de la dirección del texto.

Véase también toString().

QString QLocale::pmText() const

Devuelve el nombre traducido del sufijo «PM» para las horas especificadas según las convenciones del formato de 12 horas.

Véase también amText().

QString QLocale::positiveSign() const

Devuelve el indicador de signo positivo de esta configuración regional.

Se trata de un token que se supone que se utiliza como prefijo de un número para indicar que es positivo. A partir de Qt 6.0, se devuelve como cadena porque, en algunas configuraciones regionales, no es un solo carácter; por ejemplo, porque incluye un carácter de control de la dirección del texto.

Véase también negativeSign() y toString().

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

Devuelve « str » entre comillas según la configuración regional actual, utilizando el formato de comillas especificado en « style ».

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

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.0.

QLocale::Script QLocale::script() const

Devuelve el script de esta configuración regional.

Véase también language(), territory(), languageToString(), scriptToString() y bcp47Name().

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

Devuelve el código de escritura de cuatro letras correspondiente a « script », tal y como se define en la norma ISO 15924.

Nota: Para « QLocale::AnyScript » se devuelve una cadena vacía.

Esta función se introdujo en Qt 6.1.

Véase también script(), name(), bcp47Name(), languageToCode() y territoryToCode().

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

Devuelve un objeto ` QString ` que contiene el nombre de script.

Véase también languageToString(), territoryToString(), script() y bcp47Name().

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

Establece la configuración regional predeterminada global en locale.

Esta configuración regional se utiliza cuando se crea un objeto QLocale sin argumentos. Si no se llama a esta función, se utiliza la configuración regional del sistema.

Advertencia: En una aplicación multihilo, la configuración regional predeterminada debe establecerse al inicio de la aplicación, antes de que se creen hilos que no sean de la interfaz gráfica de usuario.

Advertencia: Esta función no es reentrante.

Véase también ` system()` y ` c()`.

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

Establece el objeto ` options ` relacionado con las conversiones numéricas para esta instancia de ` QLocale `.

Véase también numberOptions() y FloatingPointPrecisionOption.

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

Devuelve el nombre localizado de « day » (donde 1 representa el lunes, 2 el martes y así sucesivamente) que se utiliza como texto independiente, en el formato especificado por type.

Si la información de configuración regional no especifica el nombre del día por sí solo, el valor devuelto es el mismo que en ` dayName()`.

Véanse también dayName() y standaloneMonthName().

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

Devuelve el nombre localizado de « month » que se utiliza como texto independiente, en el formato especificado por « type ».

Si la información de configuración regional no especifica el nombre del mes como texto independiente, el valor devuelto es el mismo que en monthName().

Véase también monthName() y standaloneDayName().

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

Cambia esta configuración regional por other. Esta operación es muy rápida y nunca falla.

[static] QLocale QLocale::system()

Devuelve un objeto ` QLocale ` inicializado con la configuración regional del sistema.

La configuración regional del sistema puede utilizar fuentes específicas del sistema para los datos de configuración regional, cuando estén disponibles; de lo contrario, recurrirá a la entrada de la base de datos integrada de QLocale correspondiente al idioma, el alfabeto y el territorio que indique el sistema.

Por ejemplo, en Windows y Mac, esta configuración regional utilizará los caracteres decimales y de agrupación, así como los formatos de fecha y hora especificados en el panel de configuración del sistema.

Véase también c().

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

Devuelve el territorio de esta configuración regional.

Esta función se introdujo en Qt 6.2.

Véase también language(), script(), territoryToString() y bcp47Name().

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

Devuelve el código de territorio de dos letras correspondiente a territory, tal y como se define en la norma ISO 3166.

Nota: Para QLocale::AnyTerritory se devuelve una cadena vacía.

Esta función se introdujo en Qt 6.2.

Véase también codeToTerritory(), territory(), name(), bcp47Name(), languageToCode() y scriptToCode().

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

Devuelve un objeto ` QString ` que contiene el nombre de ` territory`.

Esta función se introdujo en Qt 6.2.

Véase también languageToString(), scriptToString(), territory() y bcp47Name().

Qt::LayoutDirection QLocale::textDirection() const

Devuelve la dirección del texto del idioma.

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

Devuelve el formato de hora utilizado para la configuración regional actual.

Si format es LongFormat, el formato será detallado; en caso contrario, será breve. Por ejemplo, LongFormat para la configuración regional en_US es h:mm:ss AP t, y ShortFormat es h:mm AP.

Véase también QTime::toString() y QTime::fromString().

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

Devuelve una representación en forma de cadena localizada de « value » como moneda. Si se proporciona el parámetro « symbol », se utilizará este en lugar del símbolo de moneda predeterminado.

Véase también currencySymbol().

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

Esta es una función sobrecargada.

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

Esta es una función sobrecargada.

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

Esta es una función sobrecargada.

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

Esta es una función sobrecargada.

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

Esta es una función sobrecargada.

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

Devuelve una representación en cadena localizada de « value » como moneda. Si se proporciona el parámetro « symbol », se utiliza en lugar del símbolo de moneda predeterminado. Si se proporciona el parámetro « precision », se utiliza para establecer la precisión del valor de la moneda.

Esta función sobrecarga QLocale::toCurrencyString().

Véase también currencySymbol().

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

Esta función sobrecarga la función « QLocale::toCurrencyString()».

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

Interpreta « string » como una fecha en un formato específico de la configuración regional format.

Analiza string y devuelve la fecha que representa. El formato de la cadena de fecha se elige según el parámetro format (véase dateFormat()).

Algunas configuraciones regionales utilizan, especialmente para ShortFormat, solo los dos últimos dígitos del año. En tal caso, los 100 años a partir de baseYear son los primeros candidatos que se tienen en cuenta. Antes de la versión 6.7 no existía el parámetro baseYear y siempre se utilizaba 1900. Este es el valor por defecto para baseYear, que selecciona un año desde entonces hasta 1999. En algunos casos, otros campos pueden dar lugar a que se seleccione el siglo siguiente o anterior, para obtener un resultado coherente con todos los campos proporcionados. Véase QDate::fromString() para más detalles.

Nota: Los nombresde los meses y los días, cuando se utilicen, deben indicarse en el idioma de la configuración regional.

Si no se ha podido analizar la fecha, devuelve una fecha no válida.

Véanse también dateFormat(), toTime(), toDateTime() y QDate::fromString().

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

Interpreta string como una fecha en el formato especificado format.

Analiza string y devuelve la fecha que representa. Véase QDate::fromString() para conocer la interpretación de format.

Cuando format solo especifica los dos últimos dígitos de un año, se consideran en primer lugar los 100 años que comienzan en baseYear. Antes de la versión 6.7 no existía el parámetro baseYear y siempre se utilizaba 1900. Este es el valor por defecto para baseYear, que selecciona un año desde entonces hasta 1999. En algunos casos, otros campos pueden dar lugar a que se seleccione el siglo siguiente o anterior, para obtener un resultado coherente con todos los campos proporcionados. Véase QDate::fromString() para más detalles.

Nota: Los nombresde los meses y los días, cuando se utilicen, deben indicarse en el idioma de la configuración regional.

Si no se ha podido analizar la fecha, devuelve una fecha no válida.

Véanse también dateFormat(), toTime(), toDateTime() y QDate::fromString().

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

Esta es una función sobrecargada.

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

Esta es una función sobrecargada.

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

Interpreta string como una fecha y hora en el formato específico de la configuración regional format.

Analiza string y devuelve la fecha y hora que representa. El formato de la cadena de fecha se elige según el parámetro format (véase dateFormat()).

Algunas configuraciones regionales utilizan, especialmente para ShortFormat, solo los dos últimos dígitos del año. En tal caso, se consideran en primer lugar los 100 años que comienzan en baseYear. Antes de la versión 6.7 no existía el parámetro baseYear y siempre se utilizaba 1900. Este es el valor por defecto para baseYear, que selecciona un año desde entonces hasta 1999. En algunos casos, otros campos pueden dar lugar a que se seleccione el siglo siguiente o anterior, para obtener un resultado coherente con todos los campos proporcionados. Véase QDate::fromString() para más detalles.

Nota: Los nombresde los meses y días, cuando se utilicen, deben indicarse en el idioma de la configuración regional. Cualquier indicador de «am» o «pm» que se utilice debe coincidir con amText() o pmText(), sin tener en cuenta las mayúsculas y minúsculas.

Si no se ha podido analizar la cadena, devuelve un QDateTime no válido.

Véase también dateTimeFormat(), toTime(), toDate() y QDateTime::fromString().

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

Interpreta string como una fecha y hora en el formato especificado en format.

Analiza string y devuelve la fecha y hora que representa. Consulta QDateTime::fromString() para conocer la interpretación de format.

Cuando format solo especifica los dos últimos dígitos de un año, se consideran en primer lugar los 100 años que comienzan en baseYear. Antes de la versión 6.7 no existía el parámetro baseYear y siempre se utilizaba 1900. Este es el valor por defecto para baseYear, que selecciona un año desde entonces hasta 1999. En algunos casos, otros campos pueden dar lugar a que se seleccione el siglo siguiente o anterior, para obtener un resultado coherente con todos los campos proporcionados. Véase QDate::fromString() para más detalles.

Nota: Los nombresde los meses y los días, cuando se utilicen, deben indicarse en el idioma de la configuración regional. Cualquier indicador de «am» o «pm» que se utilice debe coincidir con amText() o pmText(), sin tener en cuenta las mayúsculas y minúsculas.

Si no se ha podido analizar la cadena, devuelve un QDateTime no válido. Si la cadena se puede analizar y representa una fecha y hora no válidas (por ejemplo, en un intervalo omitido por un cambio de zona horaria), el QDateTime devuelto representa una fecha y hora cercana que sí es válida (que suele diferir de la original en la amplitud del intervalo en fechas y horas válidas, por ejemplo, la hora omitida por un cambio de zona horaria). Al pasar ese valor a fromMSecsSinceEpoch(), se obtendrá una fecha y hora válidas que no se corresponden fielmente con la cadena analizada.

Véanse también dateTimeFormat(), toTime(), toDate() y QDateTime::fromString().

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

Esta es una función sobrecargada.

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

Esta es una función sobrecargada.

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

Devuelve el valor de tipo «double» representado por la cadena localizada « s ».

Devuelve infinito si se produce un desbordamiento en la conversión o 0,0 si la conversión falla por cualquier otro motivo (por ejemplo, un desbordamiento negativo).

Si ok no es « nullptr », el error se indica estableciendo *ok en « false », y el éxito estableciendo *ok en « 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

Ten en cuenta que la última conversión devuelve 1234,0, ya que «.» es el separador de miles en la configuración regional alemana.

Esta función ignora los espacios en blanco iniciales y finales.

Véase también toFloat(), toInt() y toString().

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

Devuelve el valor de tipo «double» representado por la cadena localizada « s ».

Devuelve infinito si se produce un desbordamiento en la conversión, o 0,0 si la conversión falla por cualquier otro motivo (por ejemplo, un desbordamiento por debajo del rango).

Si ok no es « nullptr », se notifica el error estableciendo *ok en « false », y el éxito estableciendo *ok en « 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

Ten en cuenta que la última conversión devuelve 1234,0, ya que «.» es el separador de miles en la configuración regional alemana.

Esta función ignora los espacios en blanco iniciales y finales.

Véase también toFloat(), toInt() y toString().

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

Devuelve el valor flotante representado por la cadena localizada « s ».

Devuelve infinito si la conversión produce un desbordamiento por exceso o 0,0 si la conversión falla por cualquier otro motivo (por ejemplo, un desbordamiento por defecto).

Si « ok » no es « nullptr », se notifica el error estableciendo *ok en « false », y el éxito estableciendo *ok en « true ».

Esta función ignora los espacios en blanco iniciales y finales.

Véase también toDouble(), toInt() y toString().

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

Devuelve el valor flotante representado por la cadena localizada « s ».

Devuelve infinito si la conversión produce un desbordamiento por exceso o 0,0 si la conversión falla por cualquier otro motivo (por ejemplo, desbordamiento por defecto).

Si « ok » no es « nullptr », el error se indica estableciendo *ok en « false », y el éxito estableciendo *ok en « true ».

Esta función ignora los espacios en blanco iniciales y finales.

Véase también toDouble(), toInt() y toString().

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

Devuelve el valor entero representado por la cadena localizada « s ».

Si la conversión falla, la función devuelve 0.

Si ok no es « nullptr », se indica el fallo estableciendo *ok en « false », y el éxito estableciendo *ok en « true ».

Esta función ignora los espacios en blanco al principio y al final.

Véase también toUInt() y toString().

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

Devuelve el valor entero representado por la cadena localizada « s ».

Si la conversión falla, la función devuelve 0.

Si « ok » no es « nullptr », el error se indica estableciendo *ok en « false », y el éxito estableciendo *ok en « true ».

Esta función ignora los espacios en blanco al principio y al final.

Véase también toUInt() y toString().

long QLocale::toLong(QStringView s, bool *ok = nullptr) const

Devuelve el valor de tipo `long int` representado por la cadena localizada « s ».

Si la conversión falla, la función devuelve 0.

Si « ok » no es « nullptr », se notifica el error estableciendo *ok en « false », y el éxito estableciendo *ok en « true ».

Esta función ignora los espacios en blanco iniciales y finales.

Véase también toInt(), toULong(), toDouble() y toString().

long QLocale::toLong(const QString &s, bool *ok = nullptr) const

Devuelve el valor de tipo `long int` representado por la cadena localizada « s ».

Si la conversión falla, la función devuelve 0.

Si ok no es « nullptr », se notifica el fallo estableciendo *ok en « false », y el éxito estableciendo *ok en « true ».

Esta función ignora los espacios en blanco iniciales y finales.

Véase también toInt(), toULong(), toDouble() y toString().

qlonglong QLocale::toLongLong(QStringView s, bool *ok = nullptr) const

Devuelve el valor de tipo `long long int` representado por la cadena localizada « s ».

Si la conversión falla, la función devuelve 0.

Si « ok » no es « nullptr », el fallo se notifica estableciendo *ok en « false », y el éxito estableciendo *ok en « true ».

Esta función ignora los espacios en blanco iniciales y finales.

Véase también toInt(), toULongLong(), toDouble() y toString().

qlonglong QLocale::toLongLong(const QString &s, bool *ok = nullptr) const

Devuelve el valor de tipo `long long int` representado por la cadena localizada « s ».

Si la conversión falla, la función devuelve 0.

Si « ok » no es « nullptr », se notifica el error estableciendo *ok en « false », y el éxito estableciendo *ok en « true ».

Esta función ignora los espacios en blanco iniciales y finales.

Véase también toInt(), toULongLong(), toDouble() y toString().

QString QLocale::toLower(const QString &str) const

Devuelve una copia en minúsculas de ` str`.

Si Qt Core utiliza las bibliotecas ICU, estas se emplearán para realizar la transformación según las reglas de la configuración regional actual. De lo contrario, la conversión puede realizarse de forma dependiente de la plataforma, utilizando QString::toLower() como alternativa genérica.

Véase también QString::toLower().

short QLocale::toShort(QStringView s, bool *ok = nullptr) const

Devuelve el valor de tipo `short int` representado por la cadena localizada « s ».

Si la conversión falla, la función devuelve 0.

Si « ok » no es « nullptr », el fallo se notifica estableciendo *ok en « false », y el éxito estableciendo *ok en « true ».

Esta función ignora los espacios en blanco iniciales y finales.

Véase también toUShort() y toString().

short QLocale::toShort(const QString &s, bool *ok = nullptr) const

Devuelve el valor `short int` representado por la cadena localizada « s ».

Si la conversión falla, la función devuelve 0.

Si ok no es « nullptr », el error se indica estableciendo *ok en « false », y el éxito estableciendo *ok en « true ».

Esta función ignora los espacios en blanco iniciales y finales.

Véase también toUShort() y toString().

QString QLocale::toString(qlonglong i) const

Devuelve una representación en forma de cadena localizada de i.

Véase también toLongLong(), numberOptions(), zeroDigit() y positiveSign().

QString QLocale::toString(QTime time, QLocale::FormatType format = LongFormat) const

Devuelve una representación en forma de cadena localizada del objeto ` time ` dado en el ` format ` especificado (véase timeFormat()).

QString QLocale::toString(QDate date, QLocale::FormatType format, QCalendar cal) const

Devuelve una representación en forma de cadena localizada de la fecha y hora dadas ` date `, según la configuración regional especificada ` format ` (véase dateFormat()), opcionalmente para un calendario especificado ` cal`.

Nota: Algunas configuraciones regionales pueden utilizar formatos que limitan el rango de años que pueden representar. El uso de años de dos dígitos en algunas configuraciones regionales puede dar lugar a ambigüedades.

QString QLocale::toString(const QDateTime &dateTime, QLocale::FormatType format, QCalendar cal) const

Devuelve una representación en forma de cadena localizada de la fecha y hora dadas ` dateTime `, de acuerdo con el formato especificado ` format ` (véase ` dateTimeFormat()`), opcionalmente para un calendario especificado ` cal`.

Nota: Algunas configuraciones regionales pueden utilizar formatos que limitan el rango de años que pueden representar. El uso de años de dos dígitos en algunas configuraciones regionales puede dar lugar a ambigüedades.

QString QLocale::toString(const QDateTime &dateTime, QStringView format, QCalendar cal) const

Devuelve una representación en forma de cadena localizada del objeto ` dateTime ` dado, de acuerdo con la configuración de idioma especificada ` format ` (véase QDateTime::toString()), opcionalmente para un calendario especificado ` cal`.

Si format es una cadena vacía, se devuelve una cadena vacía.

Véase también QDateTime::toString(), QDate::toString() y QTime::toString().

QString QLocale::toString(int i) const

Esta es una función sobrecargada.

Véase también toInt().

QString QLocale::toString(long i) const

Esta es una función sobrecargada.

Véase también toLong().

QString QLocale::toString(qulonglong i) const

Esta es una función sobrecargada.

Véanse también toULongLong(), numberOptions(), zeroDigit() y positiveSign().

QString QLocale::toString(short i) const

Esta es una función sobrecargada.

Véase también toShort().

QString QLocale::toString(uint i) const

Esta es una función sobrecargada.

Véase también toUInt().

QString QLocale::toString(ulong i) const

Esta es una función sobrecargada.

Véase también toULong().

QString QLocale::toString(ushort i) const

Esta es una función sobrecargada.

Véase también toUShort().

QString QLocale::toString(QDate date, QLocale::FormatType format = LongFormat) const

Esta es una función sobrecargada.

QString QLocale::toString(QDate date, QStringView format) const

Esta es una función sobrecargada.

QString QLocale::toString(QDate date, const QString &format) const

Esta es una función sobrecargada.

QString QLocale::toString(QTime time, QStringView format) const

Esta es una función sobrecargada.

QString QLocale::toString(QTime time, const QString &format) const

Devuelve una representación en forma de cadena localizada del objeto ` time ` dado, de acuerdo con el objeto ` format ` especificado (véase QTime::toString()).

Si format es una cadena vacía, se devuelve una cadena vacía.

Esta es una función sobrecargada.

Véanse también dateFormat() y QTime::toString().

QString QLocale::toString(const QDateTime &dateTime, QLocale::FormatType format = LongFormat) const

Esta es una función sobrecargada.

QString QLocale::toString(const QDateTime &dateTime, QStringView format) const

Esta es una función sobrecargada.

QString QLocale::toString(const QDateTime &dateTime, const QString &format) const

Esta es una función sobrecargada.

QString QLocale::toString(QDate date, QStringView format, QCalendar cal) const

Devuelve una representación en forma de cadena localizada del « date » dado en el « format » especificado (véase QDate::toString()), opcionalmente para un calendario especificado cal.

Si format es una cadena vacía, se devuelve una cadena vacía.

Esta es una función sobrecargada.

Véanse también dateFormat() y QDate::toString().

QString QLocale::toString(double f, char format = 'g', int precision = 6) const

Devuelve una cadena que representa el número de coma flotante f.

El formato de la representación viene determinado por los parámetros format y precision.

El valor predeterminado de format es 'g'. Puede ser cualquiera de los siguientes:

FormatoSignificadoSignificado de precision
'e'formato como [-]9,9e[+|-]999número de dígitos después de la coma decimal
'E'formato como [-]9,9E[+|-]999"
'f'formato como [-]9,9»
'F'igual que « 'f' », salvo en el caso de INF y NAN (véase más abajo)"
'g'utiliza el formato 'e' o 'f', el que sea más concisoNúmero máximo de dígitos significativos (se omiten los ceros finales)
'G'utiliza el formato 'E' o 'F', el que resulte más conciso»

El valor especial de « precision », « QLocale::FloatingPointShortest », selecciona la representación más corta que, al leerse como un número, devuelve el valor original en coma flotante. Aparte de eso, cualquier valor negativo de « precision » se ignora y se utiliza el valor por defecto, 6.

En los formatos 'e', 'f' y 'g', el infinito positivo se representa como «inf», el infinito negativo como «-inf» y los valores NaN (not-a-number) de coma flotante se representan como «nan». Para los formatos 'E', 'F' y 'G', se utilizan en su lugar «INF» y «NAN». Esto no varía en función de la configuración regional.

Esta es una función sobrecargada.

Véase también toDouble(), numberOptions(), exponential(), decimalPoint(), zeroDigit(), positiveSign(), percent(), toCurrencyString(), formattedDataSize() y QLocale::FloatingPointPrecisionOption.

QString QLocale::toString(float f, char format = 'g', int precision = 6) const

Devuelve una cadena que representa el número de coma flotante f.

Las funciones format y precision tienen el mismo significado que el descrito en toString(double, char, int).

Esta es una función sobrecargada.

Véase también toFloat(), toDouble(), numberOptions(), exponential(), decimalPoint(), zeroDigit(), positiveSign(), percent(), toCurrencyString(), formattedDataSize() y QLocale::FloatingPointPrecisionOption.

QString QLocale::toString(int number, int fieldWidth, char32_t fillChar) const

QString QLocale::toString(long number, int fieldWidth, char32_t fillChar) const

QString QLocale::toString(short number, int fieldWidth, char32_t fillChar) const

Devuelve una representación en forma de cadena del valor dado number.

La longitud de la cadena será, como mínimo, el valor absoluto de fieldWidth, utilizando fillChar como relleno si number tiene menos dígitos. Si fillChar es '0', se utiliza el dígito cero de esta configuración regional como relleno. Si fieldWidth es negativo, la cadena comienza con su representación de number y, si es más corta, se rellena hasta la longitud -fieldWidth con el fillChar dado. Para un fieldWidth positivo, el relleno aparece antes de la representación de number. Cuando el number es negativo y el fieldWidth es positivo, si fillChar es un '0', el relleno se inserta entre el signo menos de esta configuración regional y el inicio de los dígitos del número.

QString QLocale::toString(qlonglong number, int fieldWidth, char32_t fillChar) const

Devuelve una representación en forma de cadena del valor dado number.

La longitud de la cadena será, como mínimo, el valor absoluto de fieldWidth, utilizando fillChar como relleno si number tiene menos dígitos. Si fillChar es '0', se utiliza el dígito cero de esta configuración regional como relleno. Si fieldWidth es negativo, la cadena comienza con su representación de number y, si es más corta, se rellena hasta la longitud -fieldWidth con el fillChar dado. Para un fieldWidth positivo, el relleno aparece antes de la representación de number. Cuando el number es negativo y fieldWidth es positivo, si fillChar es un '0', el relleno se inserta entre el signo menos de esta configuración regional y el inicio de los dígitos del número.

Esta función sobrecarga ` QLocale::toString()`.

QString QLocale::toString(qulonglong number, int fieldWidth, char32_t fillChar) const

Devuelve una representación en forma de cadena del valor dado number.

La longitud de la cadena será, como mínimo, el valor absoluto de fieldWidth, utilizando fillChar como relleno si number tiene menos dígitos. Si fillChar es '0', se utiliza el dígito cero de esta configuración regional como relleno. Si fieldWidth es negativo, la cadena comienza con su representación de number y, si es más corta, se rellena hasta la longitud -fieldWidth con el fillChar dado. Para valores positivos de fieldWidth, el relleno aparece antes de la representación de number.

Esta función sobrecarga QLocale::toString().

QString QLocale::toString(uint number, int fieldWidth, char32_t fillChar) const

QString QLocale::toString(ulong number, int fieldWidth, char32_t fillChar) const

QString QLocale::toString(ushort number, int fieldWidth, char32_t fillChar) const

Devuelve una representación en forma de cadena del valor dado number.

La longitud de la cadena será, como mínimo, el valor absoluto de ` fieldWidth`, utilizando ` fillChar ` como relleno si ` number ` tiene menos dígitos. Si ` fillChar ` es ` '0' `, se utiliza el dígito cero de esta configuración regional como relleno. Si ` fieldWidth ` es negativo, la cadena comienza con su representación de ` number ` y, si es más corta, se rellena hasta la longitud ` -fieldWidth ` con el valor dado en ` fillChar`. Para valores positivos de `fieldWidth`, el relleno aparece antes de la representación de ` number`.

QTime QLocale::toTime(const QString &string, QLocale::FormatType format = LongFormat) const

Interpreta « string » como una hora según la configuración regional específica format.

Analiza string y devuelve la hora que representa. El formato de la cadena de hora se elige según el parámetro format (véase timeFormat()).

Nota: Cualquier indicador de «am»/«pm» utilizado debe coincidir con amText() o pmText(), sin tener en cuenta las mayúsculas y minúsculas.

Si no se ha podido analizar la hora, devuelve una hora no válida.

Véase también timeFormat(), toDate(), toDateTime() y QTime::fromString().

QTime QLocale::toTime(const QString &string, const QString &format) const

Interpreta string como una hora en el formato especificado format.

Analiza string y devuelve la hora que representa. Consulta QTime::fromString() para conocer la interpretación de format.

Nota: Cualquier indicador de «am»/«pm» utilizado debe coincidir con amText() o pmText(), sin tener en cuenta las mayúsculas y minúsculas.

Si no se ha podido analizar la hora, devuelve una hora no válida.

Véase también timeFormat(), toDate(), toDateTime() y QTime::fromString().

uint QLocale::toUInt(QStringView s, bool *ok = nullptr) const

Devuelve el valor de tipo `unsigned int` representado por la cadena localizada « s ».

Si la conversión falla, la función devuelve 0.

Si « ok » no es « nullptr », el fallo se indica estableciendo *ok en « false », y el éxito estableciendo *ok en « true ».

Esta función ignora los espacios en blanco iniciales y finales.

Véase también toInt() y toString().

uint QLocale::toUInt(const QString &s, bool *ok = nullptr) const

Devuelve el entero sin signo representado por la cadena localizada « s ».

Si la conversión falla, la función devuelve 0.

Si « ok » no es « nullptr », se notifica el fallo estableciendo *ok en « false », y el éxito estableciendo *ok en « true ».

Esta función ignora los espacios en blanco iniciales y finales.

Véanse también toInt() y toString().

ulong QLocale::toULong(QStringView s, bool *ok = nullptr) const

Devuelve el valor de tipo `unsigned long int` representado por la cadena localizada « s ».

Si la conversión falla, la función devuelve 0.

Si « ok » no es « nullptr », se notifica el fallo estableciendo *ok en « false », y el éxito estableciendo *ok en « true ».

Esta función ignora los espacios en blanco iniciales y finales.

Véase también toLong(), toInt(), toDouble() y toString().

ulong QLocale::toULong(const QString &s, bool *ok = nullptr) const

Devuelve el valor de tipo «unsigned long int» representado por la cadena localizada « s ».

Si la conversión falla, la función devuelve 0.

Si ok no es « nullptr », se indica el error estableciendo *ok en « false », y el éxito estableciendo *ok en « true ».

Esta función ignora los espacios en blanco al principio y al final.

Véase también toLong(), toInt(), toDouble() y toString().

qulonglong QLocale::toULongLong(QStringView s, bool *ok = nullptr) const

Devuelve el valor de tipo `unsigned long long int` representado por la cadena localizada « s ».

Si la conversión falla, la función devuelve 0.

Si ok no es « nullptr », se notifica el fallo estableciendo *ok en « false », y el éxito estableciendo *ok en « true ».

Esta función ignora los espacios en blanco iniciales y finales.

Véase también toLongLong(), toInt(), toDouble() y toString().

qulonglong QLocale::toULongLong(const QString &s, bool *ok = nullptr) const

Devuelve el valor de tipo `long long int` sin signo representado por la cadena localizada « s ».

Si la conversión falla, la función devuelve 0.

Si « ok » no es « nullptr », se notifica el fallo estableciendo *ok en « false », y el éxito estableciendo *ok en « true ».

Esta función ignora los espacios en blanco iniciales y finales.

Véase también toLongLong(), toInt(), toDouble() y toString().

ushort QLocale::toUShort(QStringView s, bool *ok = nullptr) const

Devuelve el valor de tipo `unsigned short int` representado por la cadena localizada « s ».

Si la conversión falla, la función devuelve 0.

Si « ok » no es « nullptr », se notifica el error estableciendo *ok en « false », y el éxito estableciendo *ok en « true ».

Esta función ignora los espacios en blanco al principio y al final.

Véase también toShort() y toString().

ushort QLocale::toUShort(const QString &s, bool *ok = nullptr) const

Devuelve el valor de tipo `unsigned short int` representado por la cadena localizada « s ».

Si la conversión falla, la función devuelve 0.

Si « ok » no es « nullptr », se notifica el error estableciendo *ok en « false », y el éxito estableciendo *ok en « true ».

Esta función ignora los espacios en blanco iniciales y finales.

Véase también toShort() y toString().

QString QLocale::toUpper(const QString &str) const

Devuelve una copia en mayúsculas de ` str`.

Si Qt Core utiliza las bibliotecas ICU, estas se emplearán para realizar la transformación según las reglas de la configuración regional actual. De lo contrario, la conversión se realizará de forma dependiente de la plataforma, utilizando QString::toUpper() como alternativa genérica.

Nota: En algunos casos, la forma en mayúsculas de una cadena puede ser más larga que la original.

Véase también QString::toUpper().

QStringList QLocale::uiLanguages(QLocale::TagSeparator separator = TagSeparator::Dash) const

Lista de nombres de configuraciones regionales para seleccionar traducciones

Cada entrada de la lista devuelta es el nombre de una configuración regional adecuada a las preferencias del usuario en cuanto al idioma al que se debe traducir la interfaz de usuario. Cuando un nombre de la lista se compone de varias etiquetas, estas se unen tal y como indica separator. Antes de Qt 6.7 se utilizaba un guión como separador.

Por ejemplo, utilizando el separador predeterminado QLocale::TagSeparator::Dash, si el usuario ha configurado su sistema para utilizar el inglés de EE. UU., la lista sería «en-Latn-US», «en-US», «en-Latn», «en». El orden de las entradas es el orden en el que se comprueban las traducciones; se da preferencia a los elementos que aparecen primero en la lista frente a los que aparecen después. Si tus archivos de traducción (u otros recursos específicos de la configuración regional) utilizan guiones bajos, en lugar de guiones, para separar las etiquetas de configuración regional, pasa QLocale::TagSeparator::Underscore como separator.

Devuelve una lista de nombres de configuraciones regionales. Esta puede incluir varios idiomas, especialmente en el caso de la configuración regional del sistema cuando hay configurados varios idiomas de traducción de la interfaz de usuario. El orden de las entradas es importante. Por ejemplo, en el caso de la configuración regional del sistema, refleja las preferencias del usuario.

Antes de Qt 6.9, la lista solo contenía configuraciones regionales configuradas explícitamente y sus equivalentes. Esto llevó a algunos usuarios a añadir truncamientos (como de «en-Latn-DE» a «en») como alternativas. En ocasiones, esto podía dar lugar a elecciones inadecuadas, sobre todo si se probaban antes que entradas posteriores que serían alternativas más adecuadas.

A partir de Qt 6.9, se incluyen truncamientos razonables en la lista devuelta después de todas las entradas equivalentes a las configuraciones regionales especificadas explícitamente. Este cambio permite opciones de alternativa más precisas sin que los usuarios tengan que realizar ningún truncamiento.

Los usuarios pueden incluir explícitamente las configuraciones regionales de reserva preferidas (como «en-US») en la configuración de su sistema para controlar el orden de preferencia. Se recomienda basarse en el orden de las entradas de `uiLanguages()` en lugar de utilizar métodos de reserva personalizados.

Lo más probable es que no necesites utilizar esta función directamente, sino simplemente pasar el objeto ` QLocale ` a la función ` QTranslator::load()`.

Véase también « QTranslator » y « bcp47Name()».

QList<Qt::DayOfWeek> QLocale::weekdays() const

Devuelve una lista de los días que se consideran días laborables según la configuración regional actual.

QString QLocale::zeroDigit() const

Devuelve el carácter del dígito cero de esta configuración regional.

Se trata de un único carácter Unicode, pero puede codificarse como un par sustituto, por lo que (desde Qt 6.0) se devuelve como una cadena. En la mayoría de las configuraciones regionales, le siguen otros dígitos en el orden Unicode; sin embargo, algunos sistemas numéricos, en particular aquellos que utilizan U+3007 como cero, no tienen dígitos contiguos. Utiliza toString() para obtener representaciones adecuadas de los números, en lugar de intentar construirlos a partir de este dígito cero.

Véase también toString().

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

Asigna other a este objeto QLocale y devuelve una referencia a este objeto QLocale.

Documentación de las variables miembro

[since 6.7] const int QLocale::DefaultTwoDigitBaseYear

Esta variable contiene el año de inicio por defecto del siglo en el que se realizará la selección cuando se utilice un formato que admita un año de dos dígitos. El valor de la constante es 1900.

Algunas configuraciones regionales utilizan, especialmente para ShortFormat, solo los dos últimos dígitos del año. Antes de la versión 6.7, siempre se utilizaba el año 1900 como año base en estos casos. Ahora, varias funciones de QLocale y QDate tienen sobrecargas que permiten a los usuarios especificar el año base, y esta constante se utiliza como su valor por defecto.

Esta variable se introdujo en Qt 6.7.

Véase también toDate(), toDateTime(), QDate::fromString() y QDateTime::fromString().

Elementos no miembros relacionados

[noexcept] size_t qHash(const QLocale &key, size_t seed = 0)

Devuelve el valor hash de key, utilizando seed como semilla para el cálculo.

[noexcept] bool operator!=(const QLocale &lhs, const QLocale &rhs)

Devuelve ` true ` si los dos objetos ` QLocale `, ` lhs ` y ` rhs`, son diferentes; en caso contrario, devuelve ` false`.

Nota: La configuración regional del sistema no es igual al objeto ` QLocale ` construido a partir de sus funciones ` language()`, ` script()` y ` territory()`, aunque ambos coincidan en todos los campos de datos. Tampoco son iguales dos configuraciones regionales con opciones numéricas diferentes.

Véanse también operator==() y setNumberOptions().

[noexcept] bool operator==(const QLocale &lhs, const QLocale &rhs)

Devuelve « true » si los dos objetos « QLocale », « lhs » y « rhs », son iguales; en caso contrario, devuelve « false ».

Nota: La configuración regional del sistema no es igual al objeto ` QLocale ` construido a partir de sus funciones ` language()`, ` script()` y ` territory()`, aunque ambos coincidan en todos los campos de datos. Tampoco son iguales dos configuraciones regionales con opciones numéricas diferentes.

Véanse también operator!=() y setNumberOptions().

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