QLocale¶

PyQt5.QtCore.QLocale

Description¶

The QLocale class converts between numbers and their string representations in various languages.

QLocale is initialized with a language/country pair in its constructor and offers number-to-string and string-to-number conversion functions similar to those in QString.

Example:

# 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 supports the concept of a default locale, which is determined from the system’s locale settings at application startup. The default locale can be changed by calling the static member setDefault(). Setting the default locale has the following effects:

If a QLocale object is constructed with the default constructor, it will use the default locale’s settings.
QString::toInt(), QString::toDouble(), etc., interpret the string according to the default locale. If this fails, it falls back on the “C” locale.
QString::arg() uses the default locale to format a number when its position specifier in the format string contains an ‘L’, e.g. “%L1”.

The following example illustrates how to use QLocale directly:

# QLocale::setDefault(QLocale(QLocale::Hebrew, QLocale::Israel));
# QLocale hebrew; // Constructs a default QLocale
# QString s1 = hebrew.toString(15714.3, 'e');

# bool ok;
# double d;

# QLocale::setDefault(QLocale::C);
# d = QString("1234,56").toDouble(&ok);   // ok == false
# d = QString("1234.56").toDouble(&ok);   // ok == true, d == 1234.56

# QLocale::setDefault(QLocale::German);
# d = QString("1234,56").toDouble(&ok);   // ok == true, d == 1234.56
# d = QString("1234.56").toDouble(&ok);   // ok == true, d == 1234.56

# QLocale::setDefault(QLocale(QLocale::English, QLocale::UnitedStates));
# str = QString("%1 %L2 %L3")
#       .arg(12345).arg(12345).arg(12345, 0, 16);
# // str == "12345 12,345 3039"

When a language/country pair is specified in the constructor, one of three things can happen:

If the language/country pair is found in the database, it is used.
If the language is found but the country is not, or if the country is AnyCountry, the language is used with the most appropriate available country (for example, Germany for German),
If neither the language nor the country are found, QLocale defaults to the default locale (see setDefault()).

Use language() and country() to determine the actual language and country values used.

An alternative method for constructing a QLocale object is by specifying the locale name.

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

This constructor converts the locale name to a language/country pair; it does not use the system locale database.

Note: For the current keyboard input locale take a look at locale().

QLocale’s data is based on Common Locale Data Repository v34.

See also

locale(), QString::arg()QString::toInt()QString::toDouble().

Classes¶

DataSizeFormats

NumberOptions

Enums¶

Country

This enumerated type is used to specify a country.

See also

country(), countryToString().

Member	Value	Description
Afghanistan	TODO	TODO
AlandIslands	TODO	TODO
Albania	TODO	TODO
Algeria	TODO	TODO
AmericanSamoa	TODO	TODO
Andorra	TODO	TODO
Angola	TODO	TODO
Anguilla	TODO	TODO
Antarctica	TODO	TODO
AntiguaAndBarbuda	TODO	TODO
AnyCountry	TODO	TODO
Argentina	TODO	TODO
Armenia	TODO	TODO
Aruba	TODO	TODO
AscensionIsland	TODO	TODO
Australia	TODO	TODO
Austria	TODO	TODO
Azerbaijan	TODO	TODO
Bahamas	TODO	TODO
Bahrain	TODO	TODO
Bangladesh	TODO	TODO
Barbados	TODO	TODO
Belarus	TODO	TODO
Belgium	TODO	TODO
Belize	TODO	TODO
Benin	TODO	TODO
Bermuda	TODO	TODO
Bhutan	TODO	TODO
Bolivia	TODO	TODO
Bonaire	TODO	TODO
BosniaAndHerzegowina	TODO	TODO
Botswana	TODO	TODO
BouvetIsland	TODO	TODO
Brazil	TODO	TODO
BritishIndianOceanTerritory	TODO	TODO
BritishVirginIslands	TODO	TODO
Brunei	TODO	TODO
Bulgaria	TODO	TODO
BurkinaFaso	TODO	TODO
Burundi	TODO	TODO
Cambodia	TODO	TODO
Cameroon	TODO	TODO
Canada	TODO	TODO
CanaryIslands	TODO	TODO
CapeVerde	TODO	TODO
CaymanIslands	TODO	TODO
CentralAfricanRepublic	TODO	TODO
CeutaAndMelilla	TODO	TODO
Chad	TODO	TODO
Chile	TODO	TODO
China	TODO	TODO
ChristmasIsland	TODO	TODO
ClippertonIsland	TODO	TODO
CocosIslands	TODO	TODO
Colombia	TODO	TODO
Comoros	TODO	TODO
CongoBrazzaville	TODO	TODO
CongoKinshasa	TODO	TODO
CookIslands	TODO	TODO
CostaRica	TODO	TODO
Croatia	TODO	TODO
Cuba	TODO	TODO
CuraSao	TODO	TODO
Cyprus	TODO	TODO
CzechRepublic	TODO	TODO
DemocraticRepublicOfCongo	49	Obsolete, please use CongoKinshasa
DemocraticRepublicOfKorea	113	Obsolete, please use NorthKorea
Denmark	TODO	TODO
DiegoGarcia	TODO	TODO
Djibouti	TODO	TODO
Dominica	TODO	TODO
DominicanRepublic	TODO	TODO
EastTimor	TODO	TODO
Ecuador	TODO	TODO
Egypt	TODO	TODO
ElSalvador	TODO	TODO
EquatorialGuinea	TODO	TODO
Eritrea	TODO	TODO
Estonia	TODO	TODO
Ethiopia	TODO	TODO
Europe	TODO	Since Qt 5.12
EuropeanUnion	TODO	Since Qt 5.7
FalklandIslands	TODO	TODO
FaroeIslands	TODO	TODO
Fiji	TODO	TODO
Finland	TODO	TODO
France	TODO	TODO
FrenchGuiana	TODO	TODO
FrenchPolynesia	TODO	TODO
FrenchSouthernTerritories	TODO	TODO
Gabon	TODO	TODO
Gambia	TODO	TODO
Georgia	TODO	TODO
Germany	TODO	TODO
Ghana	TODO	TODO
Gibraltar	TODO	TODO
Greece	TODO	TODO
Greenland	TODO	TODO
Grenada	TODO	TODO
Guadeloupe	TODO	TODO
Guam	TODO	TODO
Guatemala	TODO	TODO
Guernsey	TODO	TODO
Guinea	TODO	TODO
GuineaBissau	TODO	TODO
Guyana	TODO	TODO
Haiti	TODO	TODO
HeardAndMcDonaldIslands	TODO	TODO
Honduras	TODO	TODO
HongKong	TODO	TODO
Hungary	TODO	TODO
Iceland	TODO	TODO
India	TODO	TODO
Indonesia	TODO	TODO
Iran	TODO	TODO
Iraq	TODO	TODO
Ireland	TODO	TODO
IsleOfMan	TODO	TODO
Israel	TODO	TODO
Italy	TODO	TODO
IvoryCoast	TODO	TODO
Jamaica	TODO	TODO
Japan	TODO	TODO
Jersey	TODO	TODO
Jordan	TODO	TODO
Kazakhstan	TODO	TODO
Kenya	TODO	TODO
Kiribati	TODO	TODO
Kosovo	TODO	TODO
Kuwait	TODO	TODO
Kyrgyzstan	TODO	TODO
Laos	TODO	TODO
LastCountry	TODO	TODO
LatinAmerica	TODO	TODO
LatinAmericaAndTheCaribbean	246	Obsolete, please use LatinAmerica
Latvia	TODO	TODO
Lebanon	TODO	TODO
Lesotho	TODO	TODO
Liberia	TODO	TODO
Libya	TODO	TODO
Liechtenstein	TODO	TODO
Lithuania	TODO	TODO
Luxembourg	TODO	TODO
Macau	TODO	TODO
Macedonia	TODO	TODO
Madagascar	TODO	TODO
Malawi	TODO	TODO
Malaysia	TODO	TODO
Maldives	TODO	TODO
Mali	TODO	TODO
Malta	TODO	TODO
MarshallIslands	TODO	TODO
Martinique	TODO	TODO
Mauritania	TODO	TODO
Mauritius	TODO	TODO
Mayotte	TODO	TODO
Mexico	TODO	TODO
Micronesia	TODO	TODO
Moldova	TODO	TODO
Monaco	TODO	TODO
Mongolia	TODO	TODO
Montenegro	TODO	TODO
Montserrat	TODO	TODO
Morocco	TODO	TODO
Mozambique	TODO	TODO
Myanmar	TODO	TODO
Namibia	TODO	TODO
NauruCountry	TODO	TODO
Nepal	TODO	TODO
Netherlands	TODO	TODO
NewCaledonia	TODO	TODO
NewZealand	TODO	TODO
Nicaragua	TODO	TODO
Niger	TODO	TODO
Nigeria	TODO	TODO
Niue	TODO	TODO
NorfolkIsland	TODO	TODO
NorthernMarianaIslands	TODO	TODO
NorthKorea	TODO	TODO
Norway	TODO	TODO
Oman	TODO	TODO
OutlyingOceania	TODO	Since Qt 5.7
Pakistan	TODO	TODO
Palau	TODO	TODO
PalestinianTerritories	TODO	TODO
Panama	TODO	TODO
PapuaNewGuinea	TODO	TODO
Paraguay	TODO	TODO
PeoplesRepublicOfCongo	50	Obsolete, please use CongoBrazzaville
Peru	TODO	TODO
Philippines	TODO	TODO
Pitcairn	TODO	TODO
Poland	TODO	TODO
Portugal	TODO	TODO
PuertoRico	TODO	TODO
Qatar	TODO	TODO
RepublicOfKorea	114	Obsolete, please use SouthKorea
Reunion	TODO	TODO
Romania	TODO	TODO
Russia	TODO	same as
RussianFederation	178	same as Russia
Rwanda	TODO	TODO
SaintBarthelemy	TODO	TODO
SaintHelena	TODO	TODO
SaintKittsAndNevis	TODO	TODO
SaintLucia	TODO	TODO
SaintMartin	TODO	TODO
SaintPierreAndMiquelon	TODO	TODO
SaintVincentAndTheGrenadines	TODO	TODO
Samoa	TODO	TODO
SanMarino	TODO	TODO
SaoTomeAndPrincipe	TODO	TODO
SaudiArabia	TODO	TODO
Senegal	TODO	TODO
Serbia	TODO	TODO
Seychelles	TODO	TODO
SierraLeone	TODO	TODO
Singapore	TODO	TODO
SintMaarten	TODO	TODO
Slovakia	TODO	TODO
Slovenia	TODO	TODO
SolomonIslands	TODO	TODO
Somalia	TODO	TODO
SouthAfrica	TODO	TODO
SouthGeorgiaAndTheSouthSandwichIslands	TODO	TODO
SouthKorea	TODO	TODO
SouthSudan	TODO	TODO
Spain	TODO	TODO
SriLanka	TODO	TODO
Sudan	TODO	TODO
Suriname	TODO	TODO
SvalbardAndJanMayenIslands	TODO	TODO
Swaziland	TODO	TODO
Sweden	TODO	TODO
Switzerland	TODO	TODO
Syria	TODO	TODO
SyrianArabRepublic	207	Obsolete, please use Syria
Taiwan	TODO	TODO
Tajikistan	TODO	TODO
Tanzania	TODO	TODO
Thailand	TODO	TODO
Togo	TODO	TODO
Tokelau	213	Obsolete, please use TokelauCountry
TokelauCountry	TODO	TODO
Tonga	TODO	TODO
TrinidadAndTobago	TODO	TODO
TristanDaCunha	TODO	TODO
Tunisia	TODO	TODO
Turkey	TODO	TODO
Turkmenistan	TODO	TODO
TurksAndCaicosIslands	TODO	TODO
Tuvalu	220	Obsolete, please use TuvaluCountry
TuvaluCountry	TODO	TODO
Uganda	TODO	TODO
Ukraine	TODO	TODO
UnitedArabEmirates	TODO	TODO
UnitedKingdom	TODO	TODO
UnitedStates	TODO	TODO
UnitedStatesMinorOutlyingIslands	TODO	TODO
UnitedStatesVirginIslands	TODO	TODO
Uruguay	TODO	TODO
Uzbekistan	TODO	TODO
Vanuatu	TODO	TODO
VaticanCityState	TODO	TODO
Venezuela	TODO	TODO
Vietnam	TODO	TODO
WallisAndFutunaIslands	TODO	TODO
WesternSahara	TODO	TODO
World	TODO	Since Qt 5.12
Yemen	TODO	TODO
Zambia	TODO	TODO
Zimbabwe	TODO	TODO

CurrencySymbolFormat

Specifies the format of the currency symbol.

Member	Value	Description
CurrencyDisplayName	2	a user readable name of the currency.
CurrencyIsoCode	0	a ISO-4217 code of the currency.
CurrencySymbol	1	a currency symbol.

DataSizeFormat

TODO

Member	Value	Description
DataSizeIecFormat	TODO	TODO
DataSizeSIFormat	TODO	TODO
DataSizeTraditionalFormat	TODO	TODO

FloatingPointPrecisionOption

TODO

Member	Value	Description
FloatingPointShortest	TODO	TODO

FormatType

This enum describes the types of format that can be used when converting QDate and QTime objects to strings.

See also

toString(), toString(), toString().

Member	Value	Description
LongFormat	0	The long version of day and month names; for example, returning “January” as a month name.
NarrowFormat	2	A special version of day and month names for use when space is limited; for example, returning “J” as a month name. Note that the narrow format might contain the same text for different months and days or it can even be an empty string if the locale doesn’t support narrow names, so you should avoid using it for date formatting. Also, for the system locale this format is the same as .
ShortFormat	1	The short version of day and month names; for example, returning “Jan” as a month name.

Language

This enumerated type is used to specify a language.

See also

language(), languageToString().

Member	Value	Description
Abkhazian	TODO	TODO
Afan	3	Obsolete, please use Oromo
Afar	TODO	TODO
Afrikaans	TODO	TODO
Aghem	TODO	TODO
Ahom	TODO	Since Qt 5.7
Akan	TODO	TODO
Akkadian	TODO	TODO
Akoose	TODO	Since Qt 5.3
Albanian	TODO	TODO
AmericanSignLanguage	TODO	Since Qt 5.7
Amharic	TODO	TODO
AncientEgyptian	TODO	TODO
AncientGreek	TODO	TODO
AncientNorthArabian	TODO	Since Qt 5.5
AnyLanguage	TODO	TODO
Arabic	TODO	TODO
Aragonese	TODO	TODO
Aramaic	TODO	TODO
ArdhamagadhiPrakrit	TODO	Since Qt 5.7
Armenian	TODO	TODO
Assamese	TODO	TODO
Asturian	TODO	TODO
Asu	TODO	TODO
Atsam	TODO	TODO
Avaric	TODO	TODO
Avestan	TODO	TODO
Aymara	TODO	TODO
Azerbaijani	TODO	TODO
Bafia	TODO	TODO
Balinese	TODO	TODO
Bambara	TODO	TODO
Bamun	TODO	TODO
Basaa	TODO	TODO
Bashkir	TODO	TODO
Basque	TODO	TODO
Bassa	TODO	Since Qt 5.5
BatakToba	TODO	TODO
Belarusian	TODO	TODO
Bemba	TODO	TODO
Bena	TODO	TODO
Bengali	TODO	TODO
Bhojpuri	TODO	Since Qt 5.7
Bhutani	16	Obsolete, please use Dzongkha
Bihari	TODO	TODO
Bislama	TODO	TODO
Blin	TODO	TODO
Bodo	TODO	TODO
Bosnian	TODO	TODO
Breton	TODO	TODO
Buginese	TODO	TODO
Buhid	TODO	TODO
Bulgarian	TODO	TODO
Burmese	TODO	TODO
Byelorussian	22	Obsolete, please use Belarusian
C	1	The “C” locale is identical in behavior to English/UnitedStates.
Cambodian	23	Obsolete, please use Khmer
Cantonese	TODO	Since Qt 5.7
Carian	TODO	TODO
Catalan	TODO	TODO
Cebuano	TODO	TODO
CentralKurdish	TODO	Since Qt 5.5
CentralMoroccoTamazight	TODO	TODO
Chakma	TODO	TODO
Chamorro	TODO	TODO
Chechen	TODO	TODO
Cherokee	TODO	TODO
Chewa	165	Obsolete, please use Nyanja
Chickasaw	TODO	TODO
Chiga	TODO	TODO
Chinese	TODO	TODO
Church	TODO	TODO
Chuvash	TODO	TODO
ClassicalMandaic	TODO	TODO
Colognian	TODO	TODO
CongoSwahili	TODO	TODO
Coptic	TODO	TODO
Cornish	TODO	TODO
Corsican	TODO	TODO
Cree	TODO	TODO
Croatian	TODO	TODO
Czech	TODO	TODO
Danish	TODO	TODO
Divehi	TODO	TODO
Dogri	TODO	TODO
Duala	TODO	TODO
Dutch	TODO	TODO
Dzongkha	TODO	TODO
EasternCham	TODO	TODO
EasternKayah	TODO	TODO
Embu	TODO	TODO
English	TODO	TODO
Erzya	TODO	TODO
Esperanto	TODO	TODO
Estonian	TODO	TODO
Etruscan	TODO	TODO
Ewe	TODO	TODO
Ewondo	TODO	TODO
Faroese	TODO	TODO
Fijian	TODO	TODO
Filipino	TODO	TODO
Finnish	TODO	TODO
French	TODO	TODO
Frisian	38	same as WesternFrisian
Friulian	TODO	TODO
Fulah	TODO	TODO
Ga	TODO	TODO
Gaelic	TODO	TODO
Galician	TODO	TODO
Ganda	TODO	TODO
Geez	TODO	TODO
Georgian	TODO	TODO
German	TODO	TODO
Gothic	TODO	TODO
Greek	TODO	TODO
Greenlandic	TODO	TODO
Guarani	TODO	TODO
Gujarati	TODO	TODO
Gusii	TODO	TODO
Haitian	TODO	TODO
Hanunoo	TODO	TODO
Hausa	TODO	TODO
Hawaiian	TODO	TODO
Hebrew	TODO	TODO
Herero	TODO	TODO
HieroglyphicLuwian	TODO	Since Qt 5.7
Hindi	TODO	TODO
HiriMotu	TODO	TODO
HmongNjua	TODO	Since Qt 5.5
Ho	TODO	Since Qt 5.5
Hungarian	TODO	TODO
Icelandic	TODO	TODO
Ido	TODO	TODO
Igbo	TODO	TODO
InariSami	TODO	Since Qt 5.5
Indonesian	TODO	TODO
Ingush	TODO	TODO
Interlingua	TODO	TODO
Interlingue	TODO	TODO
Inuktitut	TODO	TODO
Inupiak	TODO	TODO
Irish	TODO	TODO
Italian	TODO	TODO
Japanese	TODO	TODO
Javanese	TODO	TODO
Jju	TODO	TODO
JolaFonyi	TODO	TODO
Kabuverdianu	TODO	TODO
Kabyle	TODO	TODO
Kako	TODO	TODO
Kalenjin	TODO	TODO
Kamba	TODO	TODO
Kannada	TODO	TODO
Kanuri	TODO	TODO
Kashmiri	TODO	TODO
Kazakh	TODO	TODO
Kenyang	TODO	Since Qt 5.5
Khmer	TODO	TODO
Kiche	TODO	Since Qt 5.5
Kikuyu	TODO	TODO
Kinyarwanda	TODO	TODO
Kirghiz	TODO	TODO
Komi	TODO	TODO
Kongo	TODO	TODO
Konkani	TODO	TODO
Korean	TODO	TODO
Koro	TODO	TODO
KoyraboroSenni	TODO	TODO
KoyraChiini	TODO	TODO
Kpelle	TODO	TODO
Kurdish	TODO	TODO
Kurundi	Rundi	Obsolete, please use Rundi
Kwanyama	TODO	TODO
Kwasio	TODO	TODO
Lakota	TODO	Since Qt 5.3
Langi	TODO	TODO
Lao	TODO	TODO
LargeFloweryMiao	TODO	TODO
LastLanguage	TODO	TODO
Latin	TODO	TODO
Latvian	TODO	TODO
Lepcha	TODO	TODO
Lezghian	TODO	Since Qt 5.5
Limbu	TODO	TODO
Limburgish	TODO	TODO
LinearA	TODO	Since Qt 5.5
Lingala	TODO	TODO
Lisu	TODO	TODO
LiteraryChinese	TODO	Since Qt 5.7
Lithuanian	TODO	TODO
Lojban	TODO	TODO
LowerSorbian	TODO	Since Qt 5.5
LowGerman	TODO	TODO
Lu	TODO	TODO
LubaKatanga	TODO	TODO
LuleSami	TODO	Since Qt 5.5
Luo	TODO	TODO
Luxembourgish	TODO	TODO
Luyia	TODO	TODO
Lycian	TODO	TODO
Lydian	TODO	TODO
Macedonian	TODO	TODO
Machame	TODO	TODO
Maithili	TODO	Since Qt 5.5
MakhuwaMeetto	TODO	TODO
Makonde	TODO	TODO
Malagasy	TODO	TODO
Malay	TODO	TODO
Malayalam	TODO	TODO
Maltese	TODO	TODO
Mandingo	TODO	TODO
ManichaeanMiddlePersian	TODO	Since Qt 5.5
Manipuri	TODO	TODO
Manx	TODO	TODO
Maori	TODO	TODO
Mapuche	TODO	Since Qt 5.5
Marathi	TODO	TODO
Marshallese	TODO	TODO
Masai	TODO	TODO
Mazanderani	TODO	Since Qt 5.7
Mende	TODO	Since Qt 5.5
Meroitic	TODO	TODO
Meru	TODO	TODO
Meta	TODO	TODO
Mohawk	TODO	Since Qt 5.5
Moldavian	81	Obsolete, please use Romanian
Mongolian	TODO	TODO
Mono	TODO	Since Qt 5.5
Morisyen	TODO	TODO
Mru	TODO	Since Qt 5.7
Mundang	TODO	TODO
Muscogee	TODO	TODO
Nama	TODO	TODO
NauruLanguage	TODO	TODO
Navaho	TODO	TODO
Ndonga	TODO	TODO
Nepali	TODO	TODO
Newari	TODO	Since Qt 5.7
Ngiemboon	TODO	TODO
Ngomba	TODO	TODO
Nko	TODO	Since Qt 5.5
NorthernLuri	TODO	Since Qt 5.7
NorthernSami	TODO	TODO
NorthernSotho	TODO	TODO
NorthernThai	TODO	TODO
NorthNdebele	TODO	TODO
Norwegian	85	same as
NorwegianBokmal	Norwegian	same as Norwegian
NorwegianNynorsk	TODO	TODO
Nuer	TODO	TODO
Nyanja	TODO	TODO
Nyankole	TODO	TODO
Occitan	TODO	TODO
Ojibwa	TODO	TODO
OldIrish	TODO	TODO
OldNorse	TODO	TODO
OldPersian	TODO	TODO
OldTurkish	TODO	TODO
Oriya	TODO	TODO
Oromo	TODO	TODO
Osage	TODO	Since Qt 5.7
Ossetic	TODO	TODO
Pahlavi	TODO	TODO
Palauan	TODO	Since Qt 5.7
Pali	TODO	TODO
Papiamento	TODO	Since Qt 5.7
Parthian	TODO	TODO
Pashto	TODO	TODO
Persian	TODO	TODO
Phoenician	TODO	TODO
Polish	TODO	TODO
Portuguese	TODO	TODO
PrakritLanguage	TODO	TODO
Prussian	TODO	Since Qt 5.5
Punjabi	TODO	TODO
Quechua	TODO	TODO
Rejang	TODO	TODO
RhaetoRomance	94	Obsolete, please use Romansh
Romanian	TODO	TODO
Romansh	TODO	TODO
Rombo	TODO	TODO
Rundi	TODO	TODO
Russian	TODO	TODO
Rwa	TODO	TODO
Sabaean	TODO	TODO
Saho	TODO	TODO
Sakha	TODO	TODO
Samaritan	TODO	TODO
Samburu	TODO	TODO
Samoan	TODO	TODO
Sango	TODO	TODO
Sangu	TODO	TODO
Sanskrit	TODO	TODO
Santali	TODO	TODO
Saraiki	TODO	Since Qt 5.7
Sardinian	TODO	TODO
Saurashtra	TODO	TODO
Sena	TODO	TODO
Serbian	TODO	TODO
SerboCroatian	101	Obsolete, please use Serbian
Shambala	TODO	TODO
Shona	TODO	TODO
SichuanYi	TODO	TODO
Sicilian	TODO	TODO
Sidamo	TODO	TODO
Silesian	TODO	TODO
Sindhi	TODO	TODO
Sinhala	TODO	TODO
SkoltSami	TODO	Since Qt 5.5
Slovak	TODO	TODO
Slovenian	TODO	TODO
Soga	TODO	TODO
Somali	TODO	TODO
Sora	TODO	TODO
SouthernKurdish	TODO	TODO
SouthernSami	TODO	Since Qt 5.5
SouthernSotho	TODO	TODO
SouthNdebele	TODO	TODO
Spanish	TODO	TODO
StandardMoroccanTamazight	TODO	Since Qt 5.3
Sundanese	TODO	TODO
Swahili	TODO	TODO
Swati	TODO	TODO
Swedish	TODO	TODO
SwissGerman	TODO	TODO
Sylheti	TODO	TODO
Syriac	TODO	TODO
Tachelhit	TODO	TODO
Tagalog	115	Obsolete, please use Filipino
Tagbanwa	TODO	TODO
Tahitian	TODO	TODO
TaiDam	TODO	TODO
TaiNua	TODO	TODO
Taita	TODO	TODO
Tajik	TODO	TODO
Tamil	TODO	TODO
Tangut	TODO	Since Qt 5.7
Taroko	TODO	TODO
Tasawaq	TODO	TODO
Tatar	TODO	TODO
TedimChin	TODO	Since Qt 5.5
Telugu	TODO	TODO
Teso	TODO	TODO
Thai	TODO	TODO
Tibetan	TODO	TODO
Tigre	TODO	TODO
Tigrinya	TODO	TODO
TokelauLanguage	TODO	Since Qt 5.7
TokPisin	TODO	Since Qt 5.7
Tongan	TODO	TODO
Tsonga	TODO	TODO
Tswana	TODO	TODO
Turkish	TODO	TODO
Turkmen	TODO	TODO
TuvaluLanguage	TODO	Since Qt 5.7
Twi	127	Obsolete, please use Akan
Tyap	TODO	TODO
Ugaritic	TODO	TODO
Uighur	TODO	TODO
Uigur	128	Obsolete, please use Uighur
Ukrainian	TODO	TODO
UncodedLanguages	TODO	Since Qt 5.7
UpperSorbian	TODO	Since Qt 5.5
Urdu	TODO	TODO
Uzbek	TODO	TODO
Vai	TODO	TODO
Venda	TODO	TODO
Vietnamese	TODO	TODO
Volapuk	TODO	TODO
Vunjo	TODO	TODO
Walamo	TODO	TODO
Walloon	TODO	TODO
Walser	TODO	TODO
Warlpiri	TODO	Since Qt 5.5
Welsh	TODO	TODO
WesternBalochi	TODO	TODO
WesternFrisian	TODO	same as Frisian
Wolof	TODO	TODO
Xhosa	TODO	TODO
Yangben	TODO	TODO
Yiddish	TODO	TODO
Yoruba	TODO	TODO
Zarma	TODO	TODO
Zhuang	TODO	TODO
Zulu	TODO	TODO

MeasurementSystem

This enum defines which units are used for measurement.

Member	Value	Description
ImperialSystem	1	Provided for compatibility. Same as ImperialUSSystem
ImperialUKSystem	TODO	This value indicates imperial units, such as inches and miles as they are used in the United Kingdom.
ImperialUSSystem	TODO	This value indicates imperial units, such as inches and miles as they are used in the United States.
MetricSystem	0	This value indicates metric units, such as meters, centimeters and millimeters.

NumberOption

This enum defines a set of options for number-to-string and string-to-number conversions. They can be retrieved with numberOptions() and set with setNumberOptions().

See also

setNumberOptions(), numberOptions().

Member	Value	Description
DefaultNumberOptions	TODO	This option represents the default behavior, with group separators, with one leading zero in single digit exponents, and without trailing zeroes after the decimal dot.
IncludeTrailingZeroesAfterDot	TODO	If this option is set, the number-to-string functions will pad numbers with zeroes to the requested precision in “g” or “most concise” mode, even if the number of significant digits is lower than the requested precision. The default is to omit trailing zeroes.
OmitGroupSeparator	0x01	If this option is set, the number-to-string functions will not insert group separators in their return values. The default is to insert group separators.
OmitLeadingZeroInExponent	TODO	If this option is set, the number-to-string functions will not pad exponents with zeroes when printing floating point numbers in scientific notation. The default is to add one leading zero to single digit exponents.
RejectGroupSeparator	0x02	If this option is set, the string-to-number functions will fail if they encounter group separators in their input. The default is to accept numbers containing correctly placed group separators.
RejectLeadingZeroInExponent	TODO	If this option is set, the string-to-number functions will fail if they encounter an exponent padded with zeroes when parsing a floating point number in scientific notation. The default is to accept such padding.
RejectTrailingZeroesAfterDot	TODO	If this option is set, the string-to-number functions will fail if they encounter trailing zeroes after the decimal dot when parsing a number in scientific or decimal representation. The default is to accept trailing zeroes.

QuotationStyle

This enum defines a set of possible styles for locale specific quotation.

See also

quoteString().

Member	Value	Description
AlternateQuotation	1	If this option is set, the alternate quotation marks will be used to quote strings.
StandardQuotation	0	If this option is set, the standard quotation marks will be used to quote strings.

Script

This enumerated type is used to specify a script.

Member	Value	Description
AdlamScript	TODO	Since Qt 5.7
AhomScript	TODO	Since Qt 5.7
AnatolianHieroglyphsScript	TODO	Since Qt 5.7
AnyScript	TODO	TODO
ArabicScript	TODO	TODO
ArmenianScript	TODO	TODO
AvestanScript	TODO	TODO
BalineseScript	TODO	TODO
BamumScript	TODO	TODO
BassaVahScript	TODO	Since Qt 5.5
BatakScript	TODO	TODO
BengaliScript	TODO	TODO
BhaiksukiScript	TODO	Since Qt 5.7
BopomofoScript	TODO	TODO
BrahmiScript	TODO	TODO
BrailleScript	TODO	TODO
BugineseScript	TODO	TODO
BuhidScript	TODO	TODO
CanadianAboriginalScript	TODO	TODO
CarianScript	TODO	TODO
CaucasianAlbanianScript	TODO	Since Qt 5.5
ChakmaScript	TODO	TODO
ChamScript	TODO	TODO
CherokeeScript	TODO	TODO
CopticScript	TODO	TODO
CuneiformScript	TODO	TODO
CypriotScript	TODO	TODO
CyrillicScript	TODO	TODO
DeseretScript	TODO	TODO
DevanagariScript	TODO	TODO
DuployanScript	TODO	Since Qt 5.5
EgyptianHieroglyphsScript	TODO	TODO
ElbasanScript	TODO	Since Qt 5.5
EthiopicScript	TODO	TODO
FraserScript	TODO	TODO
GeorgianScript	TODO	TODO
GlagoliticScript	TODO	TODO
GothicScript	TODO	TODO
GranthaScript	TODO	Since Qt 5.5
GreekScript	TODO	TODO
GujaratiScript	TODO	TODO
GurmukhiScript	TODO	TODO
HangulScript	TODO	TODO
HanScript	TODO	TODO
HanunooScript	TODO	TODO
HanWithBopomofoScript	TODO	Since Qt 5.7
HatranScript	TODO	Since Qt 5.7
HebrewScript	TODO	TODO
HiraganaScript	TODO	TODO
ImperialAramaicScript	TODO	TODO
InscriptionalPahlaviScript	TODO	TODO
InscriptionalParthianScript	TODO	TODO
JamoScript	TODO	Since Qt 5.7
JapaneseScript	TODO	TODO
JavaneseScript	TODO	TODO
KaithiScript	TODO	TODO
KannadaScript	TODO	TODO
KatakanaScript	TODO	TODO
KayahLiScript	TODO	TODO
KharoshthiScript	TODO	TODO
KhmerScript	TODO	TODO
KhojkiScript	TODO	Since Qt 5.5
KhudawadiScript	TODO	Since Qt 5.5
KoreanScript	TODO	TODO
LannaScript	TODO	TODO
LaoScript	TODO	TODO
LatinScript	TODO	TODO
LepchaScript	TODO	TODO
LimbuScript	TODO	TODO
LinearAScript	TODO	Since Qt 5.5
LinearBScript	TODO	TODO
LycianScript	TODO	TODO
LydianScript	TODO	TODO
MahajaniScript	TODO	Since Qt 5.5
MalayalamScript	TODO	TODO
MandaeanScript	TODO	TODO
ManichaeanScript	TODO	Since Qt 5.5
MarchenScript	TODO	Since Qt 5.7
MeiteiMayekScript	TODO	TODO
MendeKikakuiScript	TODO	Since Qt 5.5
MeroiticCursiveScript	TODO	TODO
MeroiticScript	TODO	TODO
ModiScript	TODO	Since Qt 5.5
MongolianScript	TODO	TODO
MroScript	TODO	Since Qt 5.5
MultaniScript	TODO	Since Qt 5.7
MyanmarScript	TODO	TODO
NabataeanScript	TODO	Since Qt 5.5
NewaScript	TODO	Since Qt 5.7
NewTaiLueScript	TODO	TODO
NkoScript	TODO	TODO
OghamScript	TODO	TODO
OlChikiScript	TODO	TODO
OldHungarianScript	TODO	Since Qt 5.7
OldItalicScript	TODO	TODO
OldNorthArabianScript	TODO	Since Qt 5.5
OldPermicScript	TODO	Since Qt 5.5
OldPersianScript	TODO	TODO
OldSouthArabianScript	TODO	TODO
OriyaScript	TODO	TODO
OrkhonScript	TODO	TODO
OsageScript	TODO	Since Qt 5.7
OsmanyaScript	TODO	TODO
PahawhHmongScript	TODO	Since Qt 5.5
PalmyreneScript	TODO	Since Qt 5.5
PauCinHauScript	TODO	Since Qt 5.5
PhagsPaScript	TODO	TODO
PhoenicianScript	TODO	TODO
PollardPhoneticScript	TODO	TODO
PsalterPahlaviScript	TODO	Since Qt 5.5
RejangScript	TODO	TODO
RunicScript	TODO	TODO
SamaritanScript	TODO	TODO
SaurashtraScript	TODO	TODO
SharadaScript	TODO	TODO
ShavianScript	TODO	TODO
SiddhamScript	TODO	Since Qt 5.5
SignWritingScript	TODO	Since Qt 5.7
SimplifiedChineseScript	SimplifiedHanScript	same as
SimplifiedHanScript	5	same as
SinhalaScript	TODO	TODO
SoraSompengScript	TODO	TODO
SundaneseScript	TODO	TODO
SylotiNagriScript	TODO	TODO
SyriacScript	TODO	TODO
TagalogScript	TODO	TODO
TagbanwaScript	TODO	TODO
TaiLeScript	TODO	TODO
TaiVietScript	TODO	TODO
TakriScript	TODO	TODO
TamilScript	TODO	TODO
TangutScript	TODO	Since Qt 5.7
TeluguScript	TODO	TODO
ThaanaScript	TODO	TODO
ThaiScript	TODO	TODO
TibetanScript	TODO	TODO
TifinaghScript	TODO	TODO
TirhutaScript	TODO	Since Qt 5.5
TraditionalChineseScript	TraditionalHanScript	same as
TraditionalHanScript	6	same as
UgariticScript	TODO	TODO
VaiScript	TODO	TODO
VarangKshitiScript	TODO	Since Qt 5.5
YiScript	TODO	TODO

Methods¶

__init__(): Constructs a QLocale object initialized with the default locale. If no default locale was set using setDefault(), this locale will be the same as the one returned by system().

See also

setDefault().

__init__(str)

Constructs a QLocale object with the specified name, which has the format “language[_script][_country][.codeset][@modifier]” or “C”, where:

language is a lowercase, two-letter, ISO 639 language code (also some three-letter codes),
script is a titlecase, four-letter, ISO 15924 script code,
country is an uppercase, two-letter, ISO 3166 country code (also “419” as defined by United Nations),
and codeset and modifier are ignored.

The separator can be either underscore or a minus sign.

If the string violates the locale format, or language is not a valid ISO 639 code, the “C” locale is used instead. If country is not present, or is not a valid ISO 3166 code, the most appropriate country is chosen for the specified language.

The language, script and country codes are converted to their respective Language, Script and Country enums. After this conversion is performed, the constructor behaves exactly like QLocale(Country, Script, Language).

This constructor is much slower than QLocale(Country, Script, Language).

See also

bcp47Name().

__init__(QLocale): Constructs a QLocale object as a copy of other.

__init__(Language, country: Country = AnyCountry)

Constructs a QLocale object with the specified language and country.

If the language/country pair is found in the database, it is used.
If the language is found but the country is not, or if the country is AnyCountry, the language is used with the most appropriate available country (for example, Germany for German),
If neither the language nor the country are found, QLocale defaults to the default locale (see setDefault()).

The language and country that are actually used can be queried using language() and country().

See also

setDefault(), language(), country().

__init__(Language, Script, Country)

Constructs a QLocale object with the specified language, script and country.

If the language/script/country is found in the database, it is used.
If both script is AnyScript and country is AnyCountry, the language is used with the most appropriate available script and country (for example, Germany for German),
If either script is AnyScript or country is AnyCountry, the language is used with the first locale that matches the given script and country.
If neither the language nor the country are found, QLocale defaults to the default locale (see setDefault()).

The language, script and country that are actually used can be queried using language(), script() and country().

amText() → str: TODO

bcp47Name() → str: TODO

@staticmethod c() → QLocale: TODO

collation() → QLocale: TODO

country() → Country: TODO

@staticmethod countryToString(Country) → str: TODO

createSeparatedList(Iterable[str]) → str: TODO

currencySymbol(format: CurrencySymbolFormat = CurrencySymbol) → str: TODO

dateFormat(format: FormatType = LongFormat) → str: TODO

dateTimeFormat(format: FormatType = LongFormat) → str: TODO

dayName(int, format: FormatType = LongFormat) → str: TODO

decimalPoint() → str: TODO

__eq__(QLocale) → bool: TODO

exponential() → str: TODO

firstDayOfWeek() → DayOfWeek: TODO

formattedDataSize(int, precision: int = 2, format: Union[DataSizeFormats, DataSizeFormat] = DataSizeIecFormat) → str: TODO

groupSeparator() → str: TODO

__hash__() → int: TODO

language() → Language: TODO

@staticmethod languageToString(Language) → str: TODO

@staticmethod matchingLocales(Language, Script, Country) → List[QLocale]: TODO

measurementSystem() → MeasurementSystem: TODO

monthName(int, format: FormatType = LongFormat) → str: TODO

name() → str: TODO

nativeCountryName() → str: TODO

nativeLanguageName() → str: TODO

__ne__(QLocale) → bool: TODO

negativeSign() → str: TODO

numberOptions() → NumberOptions: See also

setNumberOptions().

percent() → str: TODO

pmText() → str: TODO

positiveSign() → str: TODO

quoteString(str, style: QuotationStyle = StandardQuotation) → str: TODO

script() → Script: TODO

@staticmethod scriptToString(Script) → str: TODO

@staticmethod setDefault(QLocale): TODO

setNumberOptions(Union[NumberOptions, NumberOption]): See also

numberOptions().

standaloneDayName(int, format: FormatType = LongFormat) → str: TODO

standaloneMonthName(int, format: FormatType = LongFormat) → str: TODO

swap(QLocale): TODO

@staticmethod system() → QLocale: TODO

textDirection() → LayoutDirection: TODO

timeFormat(format: FormatType = LongFormat) → str: TODO

toCurrencyString(float, symbol: str = '') → str: TODO

toCurrencyString(int, symbol: str = '') → str: TODO

toCurrencyString(float, str, int) → str: TODO

toDate(str, format: FormatType = LongFormat) → QDate: TODO

toDate(str, str) → QDate: TODO

toDate(str, FormatType, QCalendar) → QDate: TODO

toDate(str, str, QCalendar) → QDate: TODO

toDateTime(str, format: FormatType = LongFormat) → QDateTime: TODO

toDateTime(str, str) → QDateTime: TODO

toDateTime(str, FormatType, QCalendar) → QDateTime: TODO

toDateTime(str, str, QCalendar) → QDateTime: TODO

toDouble(str) → (float, bool): TODO

toFloat(str) → (float, bool): TODO

toInt(str) → (int, bool): TODO

toLong(str) → (int, bool): TODO

toLongLong(str) → (int, bool): TODO

toLower(str) → str: TODO

toShort(str) → (int, bool): TODO

toString(int) → str: TODO

toString(Union[QDateTime, datetime.datetime], str) → str: TODO

toString(Union[QDateTime, datetime.datetime], format: FormatType = LongFormat) → str: TODO

toString(Union[QDate, datetime.date], str) → str: TODO

toString(Union[QDate, datetime.date], format: FormatType = LongFormat) → str: TODO

toString(Union[QTime, datetime.time], str) → str: TODO

toString(Union[QTime, datetime.time], format: FormatType = LongFormat) → str: TODO

toString(float, format: str = 'g', precision: int = 6) → str: TODO

toString(Union[QDateTime, datetime.datetime], str, QCalendar) → str: TODO

toString(Union[QDateTime, datetime.datetime], FormatType, QCalendar) → str: TODO

toString(Union[QDate, datetime.date], str, QCalendar) → str: TODO

toString(Union[QDate, datetime.date], FormatType, QCalendar) → str: TODO

toTime(str, format: FormatType = LongFormat) → QTime: TODO

toTime(str, str) → QTime: TODO

toTime(str, FormatType, QCalendar) → QTime: TODO

toTime(str, str, QCalendar) → QTime: TODO

toUInt(str) → (int, bool): TODO

toULong(str) → (int, bool): TODO

toULongLong(str) → (int, bool): TODO

toUpper(str) → str: TODO

toUShort(str) → (int, bool): TODO

uiLanguages() → List[str]: TODO

weekdays() → List[DayOfWeek]: TODO

zeroDigit() → str: TODO