QLocale

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

Synopsis

Functions

• def __eq__ (other)

• def __ne__ (other)

• def amText ()

• def bcp47Name ()

• def collation ()

• def country ()

• def createSeparatedList (strl)

• def currencySymbol ([arg__1=CurrencySymbol])

• def dateFormat ([format=LongFormat])

• def dateTimeFormat ([format=LongFormat])

• def dayName (arg__1[, format=LongFormat])

• def decimalPoint ()

• def exponential ()

• def firstDayOfWeek ()

• def formattedDataSize (bytes[, precision=2[, format=QLocale.DataSizeIecFormat]])

• def groupSeparator ()

• def language ()

• def measurementSystem ()

• def monthName (arg__1[, format=LongFormat])

• def name ()

• def nativeCountryName ()

• def nativeLanguageName ()

• def negativeSign ()

• def numberOptions ()

• def percent ()

• def pmText ()

• def positiveSign ()

• def quoteString (str[, style=StandardQuotation])

• def quoteString (str[, style=StandardQuotation])

• def script ()

• def setNumberOptions (options)

• def standaloneDayName (arg__1[, format=LongFormat])

• def standaloneMonthName (arg__1[, format=LongFormat])

• def swap (other)

• def textDirection ()

• def timeFormat ([format=LongFormat])

• def toCurrencyString (arg__1, symbol, precision)

• def toCurrencyString (arg__1[, symbol=””])

• def toCurrencyString (arg__1[, symbol=””])

• def toCurrencyString (arg__1[, symbol=””])

• def toCurrencyString (arg__1[, symbol=””])

• def toCurrencyString (arg__1[, symbol=””])

• def toCurrencyString (arg__1[, symbol=””])

• def toCurrencyString (arg__1[, symbol=””])

• def toCurrencyString (i, symbol, precision)

• def toCurrencyString (i[, symbol=””])

• def toDate (string, format)

• def toDate (string, format, cal)

• def toDate (string, format, cal)

• def toDate (string[, format=LongFormat])

• def toDateTime (string, format)

• def toDateTime (string, format, cal)

• def toDateTime (string, format, cal)

• def toDateTime (string[, format=LongFormat])

• def toDouble (s)

• def toFloat (s)

• def toInt (s)

• def toLong (s[, ok=None])

• def toLong (s[, ok=None])

• def toLongLong (s)

• def toLower (str)

• def toShort (s)

• def toString (date, format, cal)

• def toString (date, formatStr)

• def toString (dateTime, format)

• def toString (dateTime, format, cal)

• def toString (dateTime[, format=LongFormat])

• def toString (date[, format=LongFormat])

• def toString (i)

• def toString (i)

• def toString (i)

• def toString (i)

• def toString (i)

• def toString (i[, f=’g’[, prec=6]])

• def toString (i[, f=’g’[, prec=6]])

• def toString (time, formatStr)

• def toString (time[, format=LongFormat])

• def toTime (string, format)

• def toTime (string, format, cal)

• def toTime (string, format, cal)

• def toTime (string[, format=LongFormat])

• def toUInt (s)

• def toULong (s[, ok=None])

• def toULong (s[, ok=None])

• def toULongLong (s)

• def toUShort (s)

• def toUpper (str)

• def uiLanguages ()

• def weekdays ()

• def zeroDigit ()

Static functions

• def c ()

• def countriesForLanguage (lang)

• def countryToString (country)

• def languageToString (language)

• def matchingLocales (language, script, country)

• def scriptToString (script)

• def setDefault (locale)

• def system ()

Detailed Description

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:

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

(d, ok) = egyptian.toDouble(s1)
(i, ok) = 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.

• toInt() , toDouble() , etc., interpret the string according to the default locale. If this fails, it falls back on the “C” locale.

• 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))
hebrew = QLocale() # Constructs a default QLocale
s1 = hebrew.toString(15714.3, 'e')

QLocale.setDefault(QLocale(QLocale.C))
c = QLocale()
(d, ok) = c.toDouble("1234,56")   # ok == false
(d, ok) = c.toDouble("1234.56")   # ok == true, d == 1234.56

QLocale.setDefault(QLocale(QLocale.German))
german = QLocale()
(d, ok) = german.toDouble("1234,56")   # ok == true, d == 1234.56
(d, ok) = german.toDouble("1234.56")   # ok == true, d == 1234.56

QLocale.setDefault(QLocale(QLocale.English, QLocale.UnitedStates))
english = QLocale()
string = '%s %s %10x' % (12345, english.toString(12345), 12345)
# string == "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.

korean = QLocale("ko")
swiss = QLocale("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 v39.

See also

arg() toInt() toDouble() locale()

class PySide2.QtCore.QLocale

PySide2.QtCore.QLocale(language[, country=AnyCountry])

PySide2.QtCore.QLocale(language, script, country)

PySide2.QtCore.QLocale(other)

PySide2.QtCore.QLocale(name)

param name:

str

param script:

Script

param language:

Language

param other:

PySide2.QtCore.QLocale

param country:

Country

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()

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()

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() .

See also

setDefault() language() script() country()

PySide2.QtCore.QLocale.Language

This enumerated type is used to specify a language.

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

See also

language() languageToString()

PySide2.QtCore.QLocale.Script

This enumerated type is used to specify a script.

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

See also

script() scriptToString() languageToString()

New in version 4.8.

PySide2.QtCore.QLocale.Country

This enumerated type is used to specify a country.

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

See also

country() countryToString()

PySide2.QtCore.QLocale.MeasurementSystem

This enum defines which units are used for measurement.

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

PySide2.QtCore.QLocale.FormatType

This enum describes the different formats that can be used when converting QDate , QTime , and QDateTime objects, as well as months and days, to strings specific to the locale.

Constant	Description
QLocale.LongFormat	Longer format.
QLocale.ShortFormat	Shorter format.
QLocale.NarrowFormat	A special version for use when space is very limited.

Note

NarrowFormat might contain the same text for different months and days. 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 .

See also

dateFormat() timeFormat() dateTimeFormat() monthName() standaloneMonthName() dayName() standaloneDayName() toDate() toTime() toDateTime()

PySide2.QtCore.QLocale.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() .

Constant	Description
QLocale.DefaultNumberOptions	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.
QLocale.OmitGroupSeparator	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.
QLocale.RejectGroupSeparator	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.
QLocale.OmitLeadingZeroInExponent	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.
QLocale.RejectLeadingZeroInExponent	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.
QLocale.IncludeTrailingZeroesAfterDot	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.
QLocale.RejectTrailingZeroesAfterDot	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.

See also

setNumberOptions() numberOptions()

PySide2.QtCore.QLocale.FloatingPointPrecisionOption

This enum defines constants that can be given as precision to number() , number() , and toString() when converting floats or doubles, in order to express a variable number of digits as precision.

Constant	Description
QLocale.FloatingPointShortest	The conversion algorithm will try to find the shortest accurate representation for the given number. “Accurate” means that you get the exact same number back from an inverse conversion on the generated string representation.

See also

toString() QString QByteArray

New in version 5.7.

PySide2.QtCore.QLocale.CurrencySymbolFormat

Specifies the format of the currency symbol.

Constant	Description
QLocale.CurrencyIsoCode	a ISO-4217 code of the currency.
QLocale.CurrencySymbol	a currency symbol.
QLocale.CurrencyDisplayName	a user readable name of the currency.

New in version 4.8.

PySide2.QtCore.QLocale.DataSizeFormat

Specifies the format for representation of data quantities.

Constant	Description
QLocale.DataSizeIecFormat	format using base 1024 and IEC prefixes: KiB, MiB, GiB, …
QLocale.DataSizeTraditionalFormat	format using base 1024 and SI prefixes: kB, MB, GB, …
QLocale.DataSizeSIFormat	format using base 1000 and SI prefixes: kB, MB, GB, …

See also

formattedDataSize()

New in version 5.10.

PySide2.QtCore.QLocale.QuotationStyle

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

Constant	Description
QLocale.StandardQuotation	If this option is set, the standard quotation marks will be used to quote strings.
QLocale.AlternateQuotation	If this option is set, the alternate quotation marks will be used to quote strings.

See also

quoteString()

New in version 4.8.

PySide2.QtCore.QLocale.amText()

Return type:

str

Returns the localized name of the “AM” suffix for times specified using the conventions of the 12-hour clock.

See also

pmText()

PySide2.QtCore.QLocale.bcp47Name()

Return type:

str

Returns the dash-separated language, script and country (and possibly other BCP47 fields) of this locale as a string.

Unlike the uiLanguages() the returned value of the represents the locale name of the QLocale data but not the language the user-interface should be in.

This function tries to conform the locale name to BCP47.

See also

language() country() script() uiLanguages()

static PySide2.QtCore.QLocale.c()

Return type:

PySide2.QtCore.QLocale

Returns a QLocale object initialized to the “C” locale.

This locale is based on en_US but with various quirks of its own, such as simplified number formatting and its own date formatting. It implements the POSIX standards that describe the behavior of standard library functions of the “C” programming language.

Among other things, this means its collation order is based on the ASCII values of letters, so that (for case-sensitive sorting) all upper-case letters sort before any lower-case one (rather than each letter’s upper- and lower-case forms sorting adjacent to one another, before the next letter’s two forms).

See also

system()

PySide2.QtCore.QLocale.collation()

Return type:

PySide2.QtCore.QLocale

Returns the locale to use for collation.

The result is usually this locale; however, the system locale (which is commonly the default locale) will return the system collation locale. The result is suitable for passing to QCollator ‘s constructor.

See also

QCollator

static PySide2.QtCore.QLocale.countriesForLanguage(lang)

Parameters:

lang – Language

Return type:

Returns the list of countries that have entries for language in Qt’s locale database. If the result is an empty list, then language is not represented in Qt’s locale database.

See also

matchingLocales()

PySide2.QtCore.QLocale.country()

Return type:

Country

Returns the country of this locale.

See also

language() script() countryToString() bcp47Name()

static PySide2.QtCore.QLocale.countryToString(country)

Parameters:

country – Country

Return type:

str

Returns a QString containing the name of country .

See also

languageToString() scriptToString() country() bcp47Name()

PySide2.QtCore.QLocale.createSeparatedList(strl)

Parameters:

strl – list of strings

Return type:

str

Returns a string that represents a join of a given list of strings with a separator defined by the locale.

PySide2.QtCore.QLocale.currencySymbol([arg__1=CurrencySymbol])

Parameters:

arg__1 – CurrencySymbolFormat

Return type:

str

Returns a currency symbol according to the format .

PySide2.QtCore.QLocale.dateFormat([format=LongFormat])

Parameters:

format – FormatType

Return type:

str

Returns the date format used for the current locale.

If format is LongFormat , the format will be elaborate, otherwise it will be short. For example, LongFormat for the en_US locale is dddd, MMMM d, yyyy , ShortFormat is M/d/yy .

See also

toString() fromString()

PySide2.QtCore.QLocale.dateTimeFormat([format=LongFormat])

Parameters:

format – FormatType

Return type:

str

Returns the date time format used for the current locale.

If format is LongFormat , the format will be elaborate, otherwise it will be short. For example, LongFormat for the en_US locale is dddd, MMMM d, yyyy h:mm:ss AP t , ShortFormat is M/d/yy h:mm AP .

See also

toString() fromString()

PySide2.QtCore.QLocale.dayName(arg__1[, format=LongFormat])

Parameters:

• arg__1 – int

• format – FormatType

Return type:

str

Returns the localized name of the day (where 1 represents Monday, 2 represents Tuesday and so on), in the format specified by type .

For example, if the locale is en_US and day is 1, LongFormat will return Monday , ShortFormat Mon , and NarrowFormat M .

See also

monthName() standaloneDayName()

PySide2.QtCore.QLocale.decimalPoint()

Return type:

QChar

Returns the decimal point character of this locale.

Note

This function shall change to return a QString instead of QChar in Qt6. Callers are encouraged to exploit the QString ( QChar ) constructor to convert early in preparation for this.

See also

groupSeparator() toString()

PySide2.QtCore.QLocale.exponential()

Return type:

QChar

Returns the exponential character of this locale, used to separate exponent from mantissa in some floating-point numeric representations.

Note

This function shall change to return a QString instead of QChar in Qt6. Callers are encouraged to exploit the QString ( QChar ) constructor to convert early in preparation for this.

See also

toString(double, char, int)

PySide2.QtCore.QLocale.firstDayOfWeek()

Return type:

DayOfWeek

Returns the first day of the week according to the current locale.

PySide2.QtCore.QLocale.formattedDataSize(bytes[, precision=2[, format=QLocale.DataSizeIecFormat]])

Parameters:

• bytes – int

• precision – int

• format – DataSizeFormats

Return type:

str

Converts a size in bytes to a human-readable localized string, comprising a number and a quantified unit. The quantifier is chosen such that the number is at least one, and as small as possible. For example if bytes is 16384, precision is 2, and format is DataSizeIecFormat (the default), this function returns “16.00 KiB”; for 1330409069609 bytes it returns “1.21 GiB”; and so on. If format is DataSizeIecFormat or DataSizeTraditionalFormat , the given number of bytes is divided by a power of 1024, with result less than 1024; for DataSizeSIFormat , it is divided by a power of 1000, with result less than 1000. DataSizeIecFormat uses the new IEC standard quantifiers Ki, Mi and so on, whereas DataSizeSIFormat uses the older SI quantifiers k, M, etc., and DataSizeTraditionalFormat abuses them.

PySide2.QtCore.QLocale.groupSeparator()

Return type:

QChar

Returns the group separator character of this locale.

Note

This function shall change to return a QString instead of QChar in Qt6. Callers are encouraged to exploit the QString ( QChar ) constructor to convert early in preparation for this.

See also

decimalPoint() toString()

PySide2.QtCore.QLocale.language()

Return type:

Language

Returns the language of this locale.

See also

script() country() languageToString() bcp47Name()

static PySide2.QtCore.QLocale.languageToString(language)

Parameters:

language – Language

Return type:

str

Returns a QString containing the name of language .

See also

countryToString() scriptToString() bcp47Name()

static PySide2.QtCore.QLocale.matchingLocales(language, script, country)

Parameters:

• language – Language

• script – Script

• country – Country

Return type:

Returns a list of valid locale objects that match the given language , script and country .

Getting a list of all locales: QList < QLocale > allLocales = ( AnyLanguage , AnyScript , AnyCountry );

Getting a list of locales suitable for Russia: QList < QLocale > locales = ( AnyLanguage , AnyScript , Russia );

PySide2.QtCore.QLocale.measurementSystem()

Return type:

MeasurementSystem

Returns the measurement system for the locale.

PySide2.QtCore.QLocale.monthName(arg__1[, format=LongFormat])

Parameters:

• arg__1 – int

• format – FormatType

Return type:

str

Returns the localized name of month , in the format specified by type .

For example, if the locale is en_US and month is 1, LongFormat will return January . ShortFormat Jan , and NarrowFormat J .

See also

dayName() standaloneMonthName()

PySide2.QtCore.QLocale.name()

Return type:

str

Returns the language and country of this locale as a string of the form “language_country”, where language is a lowercase, two-letter ISO 639 language code, and country is an uppercase, two- or three-letter ISO 3166 country code.

Note that even if QLocale object was constructed with an explicit script, will not contain it for compatibility reasons. Use bcp47Name() instead if you need a full locale name.

See also

QLocale() language() script() country() bcp47Name()

PySide2.QtCore.QLocale.nativeCountryName()

Return type:

str

Returns a native name of the country for the locale. For example “España” for Spanish/Spain locale.

See also

nativeLanguageName() countryToString()

PySide2.QtCore.QLocale.nativeLanguageName()

Return type:

str

Returns a native name of the language for the locale. For example “Schwiizertüütsch” for Swiss-German locale.

See also

nativeCountryName() languageToString()

PySide2.QtCore.QLocale.negativeSign()

Return type:

QChar

Returns the negative sign character of this locale.

Note

This function shall change to return a QString instead of QChar in Qt6. Callers are encouraged to exploit the QString ( QChar ) constructor to convert early in preparation for this.

See also

positiveSign() toString()

PySide2.QtCore.QLocale.numberOptions()

Return type:

NumberOptions

Returns the options related to number conversions for this QLocale instance.

By default, no options are set for the standard locales, except for the “C” locale, which has OmitGroupSeparator set by default.

See also

setNumberOptions() toString() groupSeparator()

PySide2.QtCore.QLocale.__ne__(other)

Parameters:

other – PySide2.QtCore.QLocale

Return type:

bool

Returns true if the QLocale object is not the same as the other locale specified; otherwise returns false .

PySide2.QtCore.QLocale.__eq__(other)

Parameters:

other – PySide2.QtCore.QLocale

Return type:

bool

Returns true if the QLocale object is the same as the other locale specified; otherwise returns false .

PySide2.QtCore.QLocale.percent()

Return type:

QChar

Returns the percent character of this locale.

Note

This function shall change to return a QString instead of QChar in Qt6. Callers are encouraged to exploit the QString ( QChar ) constructor to convert early in preparation for this.

See also

toString()

PySide2.QtCore.QLocale.pmText()

Return type:

str

Returns the localized name of the “PM” suffix for times specified using the conventions of the 12-hour clock.

See also

amText()

PySide2.QtCore.QLocale.positiveSign()

Return type:

QChar

Returns the positive sign character of this locale.

Note

This function shall change to return a QString instead of QChar in Qt6. Callers are encouraged to exploit the QString ( QChar ) constructor to convert early in preparation for this.

See also

negativeSign() toString()

PySide2.QtCore.QLocale.quoteString(str[, style=StandardQuotation])

Parameters:

• str – str

• style – QuotationStyle

Return type:

str

PySide2.QtCore.QLocale.quoteString(str[, style=StandardQuotation])

Parameters:

• str – QStringRef

• style – QuotationStyle

Return type:

str

PySide2.QtCore.QLocale.script()

Return type:

Script

Returns the script of this locale.

See also

language() country() languageToString() scriptToString() bcp47Name()

static PySide2.QtCore.QLocale.scriptToString(script)

Parameters:

script – Script

Return type:

str

Returns a QString containing the name of script .

See also

languageToString() countryToString() script() bcp47Name()

static PySide2.QtCore.QLocale.setDefault(locale)

Parameters:

locale – PySide2.QtCore.QLocale

Sets the global default locale to locale . These values are used when a QLocale object is constructed with no arguments. If this function is not called, the system’s locale is used.

Warning

In a multithreaded application, the default locale should be set at application startup, before any non-GUI threads are created.

See also

system() c()

PySide2.QtCore.QLocale.setNumberOptions(options)

Parameters:

options – NumberOptions

Sets the options related to number conversions for this QLocale instance.

See also

numberOptions()

PySide2.QtCore.QLocale.standaloneDayName(arg__1[, format=LongFormat])

Parameters:

• arg__1 – int

• format – FormatType

Return type:

str

Returns the localized name of the day (where 1 represents Monday, 2 represents Tuesday and so on) that is used as a standalone text, in the format specified by type .

If the locale information does not specify the standalone day name then return value is the same as in dayName() .

See also

dayName() standaloneMonthName()

PySide2.QtCore.QLocale.standaloneMonthName(arg__1[, format=LongFormat])

Parameters:

• arg__1 – int

• format – FormatType

Return type:

str

Returns the localized name of month that is used as a standalone text, in the format specified by type .

If the locale information doesn’t specify the standalone month name then return value is the same as in monthName() .

See also

monthName() standaloneDayName()

PySide2.QtCore.QLocale.swap(other)

Parameters:

other – PySide2.QtCore.QLocale

Swaps locale other with this locale. This operation is very fast and never fails.

static PySide2.QtCore.QLocale.system()

Return type:

PySide2.QtCore.QLocale

Returns a QLocale object initialized to the system locale.

On Windows and Mac, this locale will use the decimal/grouping characters and date/time formats specified in the system configuration panel.

See also

c()

PySide2.QtCore.QLocale.textDirection()

Return type:

LayoutDirection

Returns the text direction of the language.

PySide2.QtCore.QLocale.timeFormat([format=LongFormat])

Parameters:

format – FormatType

Return type:

str

Returns the time format used for the current locale.

If format is LongFormat , the format will be elaborate, otherwise it will be short. For example, LongFormat for the en_US locale is h:mm:ss AP t , ShortFormat is h:mm AP .

See also

toString() fromString()

PySide2.QtCore.QLocale.toCurrencyString(arg__1[, symbol=""])

Parameters:

• arg__1 – ushort

• symbol – str

Return type:

str

PySide2.QtCore.QLocale.toCurrencyString(arg__1[, symbol=""])

Parameters:

• arg__1 – uint

• symbol – str

Return type:

str

PySide2.QtCore.QLocale.toCurrencyString(arg__1[, symbol=""])

Parameters:

• arg__1 – short

• symbol – str

Return type:

str

PySide2.QtCore.QLocale.toCurrencyString(arg__1[, symbol=""])

Parameters:

• arg__1 – qulonglong

• symbol – str

Return type:

str

PySide2.QtCore.QLocale.toCurrencyString(arg__1[, symbol=""])

Parameters:

• arg__1 – qlonglong

• symbol – str

Return type:

str

PySide2.QtCore.QLocale.toCurrencyString(i, symbol, precision)

Parameters:

• i – float

• symbol – str

• precision – int

Return type:

str

PySide2.QtCore.QLocale.toCurrencyString(arg__1[, symbol=""])

Parameters:

• arg__1 – int

• symbol – str

Return type:

str

PySide2.QtCore.QLocale.toCurrencyString(arg__1[, symbol=""])

Parameters:

• arg__1 – double

• symbol – str

Return type:

str

PySide2.QtCore.QLocale.toCurrencyString(arg__1, symbol, precision)

Parameters:

• arg__1 – double

• symbol – str

• precision – int

Return type:

str

PySide2.QtCore.QLocale.toCurrencyString(i[, symbol=""])

Parameters:

• i – float

• symbol – str

Return type:

str

PySide2.QtCore.QLocale.toDate(string[, format=LongFormat])

Parameters:

• string – str

• format – FormatType

Return type:

PySide2.QtCore.QDate

PySide2.QtCore.QLocale.toDate(string, format, cal)

Parameters:

• string – str

• format – FormatType

• cal – PySide2.QtCore.QCalendar

Return type:

PySide2.QtCore.QDate

PySide2.QtCore.QLocale.toDate(string, format)

Parameters:

• string – str

• format – str

Return type:

PySide2.QtCore.QDate

PySide2.QtCore.QLocale.toDate(string, format, cal)

Parameters:

• string – str

• format – str

• cal – PySide2.QtCore.QCalendar

Return type:

PySide2.QtCore.QDate

PySide2.QtCore.QLocale.toDateTime(string[, format=LongFormat])

Parameters:

• string – str

• format – FormatType

Return type:

PySide2.QtCore.QDateTime

PySide2.QtCore.QLocale.toDateTime(string, format, cal)

Parameters:

• string – str

• format – FormatType

• cal – PySide2.QtCore.QCalendar

Return type:

PySide2.QtCore.QDateTime

PySide2.QtCore.QLocale.toDateTime(string, format)

Parameters:

• string – str

• format – str

Return type:

PySide2.QtCore.QDateTime

PySide2.QtCore.QLocale.toDateTime(string, format, cal)

Parameters:

• string – str

• format – str

• cal – PySide2.QtCore.QCalendar

Return type:

PySide2.QtCore.QDateTime

PySide2.QtCore.QLocale.toDouble(s)

Parameters:

s – str

Return type:

(float, bool ok)

PySide2.QtCore.QLocale.toFloat(s)

Parameters:

s – str

Return type:

(float, bool ok)

PySide2.QtCore.QLocale.toInt(s)

Parameters:

s – str

Return type:

(int, bool ok)

PySide2.QtCore.QLocale.toLong(s[, ok=None])

Parameters:

• s – str

• ok – bool

Return type:

long

PySide2.QtCore.QLocale.toLong(s[, ok=None])

Parameters:

• s – QStringRef

• ok – bool

Return type:

long

PySide2.QtCore.QLocale.toLongLong(s)

Parameters:

s – str

Return type:

(int, bool ok)

PySide2.QtCore.QLocale.toLower(str)

Parameters:

str – str

Return type:

str

Returns a lowercase copy of str .

If Qt Core is using the ICU libraries, they will be used to perform the transformation according to the rules of the current locale. Otherwise the conversion may be done in a platform-dependent manner, with toLower() as a generic fallback.

See also

toLower()

PySide2.QtCore.QLocale.toShort(s)

Parameters:

s – str

Return type:

(int, bool ok)

PySide2.QtCore.QLocale.toString(i)

Parameters:

i – int

Return type:

str

This is an overloaded function.

See also

toInt()

PySide2.QtCore.QLocale.toString(i)

Parameters:

i – long

Return type:

str

This is an overloaded function.

See also

toLong()

PySide2.QtCore.QLocale.toString(i)

Parameters:

i – qlonglong

Return type:

str

Returns a localized string representation of i .

See also

toLongLong() numberOptions() zeroDigit() positiveSign()

PySide2.QtCore.QLocale.toString(dateTime, format, cal)

Parameters:

• dateTime – PySide2.QtCore.QDateTime

• format – FormatType

• cal – PySide2.QtCore.QCalendar

Return type:

str

PySide2.QtCore.QLocale.toString(i)

Parameters:

i – short

Return type:

str

This is an overloaded function.

See also

toShort()

PySide2.QtCore.QLocale.toString(i)

Parameters:

i – ulong

Return type:

str

This is an overloaded function.

See also

toULong()

PySide2.QtCore.QLocale.toString(i[, f='g'[, prec=6]])

Parameters:

• i – double

• f – char

• prec – int

Return type:

str

This is an overloaded function.

f and prec have the same meaning as in number (double, char, int).

See also

toDouble() numberOptions() exponential() decimalPoint() zeroDigit() positiveSign() percent()

PySide2.QtCore.QLocale.toString(time, formatStr)

Parameters:

• time – PySide2.QtCore.QTime

• formatStr – str

Return type:

str

PySide2.QtCore.QLocale.toString(time[, format=LongFormat])

Parameters:

• time – PySide2.QtCore.QTime

• format – FormatType

Return type:

str

PySide2.QtCore.QLocale.toString(dateTime, format)

Parameters:

• dateTime – PySide2.QtCore.QDateTime

• format – str

Return type:

str

PySide2.QtCore.QLocale.toString(dateTime[, format=LongFormat])

Parameters:

• dateTime – PySide2.QtCore.QDateTime

• format – FormatType

Return type:

str

PySide2.QtCore.QLocale.toString(date, formatStr)

Parameters:

• date – PySide2.QtCore.QDate

• formatStr – str

Return type:

str

PySide2.QtCore.QLocale.toString(date, format, cal)

Parameters:

• date – PySide2.QtCore.QDate

• format – FormatType

• cal – PySide2.QtCore.QCalendar

Return type:

str

PySide2.QtCore.QLocale.toString(date[, format=LongFormat])

Parameters:

• date – PySide2.QtCore.QDate

• format – FormatType

Return type:

str

PySide2.QtCore.QLocale.toString(i[, f='g'[, prec=6]])

Parameters:

• i – float

• f – char

• prec – int

Return type:

str

This is an overloaded function.

f and prec have the same meaning as in number (double, char, int).

See also

toDouble()

PySide2.QtCore.QLocale.toTime(string, format, cal)

Parameters:

• string – str

• format – str

• cal – PySide2.QtCore.QCalendar

Return type:

PySide2.QtCore.QTime

Note

This function is deprecated.

PySide2.QtCore.QLocale.toTime(string, format)

Parameters:

• string – str

• format – str

Return type:

PySide2.QtCore.QTime

PySide2.QtCore.QLocale.toTime(string, format, cal)

Parameters:

• string – str

• format – FormatType

• cal – PySide2.QtCore.QCalendar

Return type:

PySide2.QtCore.QTime

Note

This function is deprecated.

PySide2.QtCore.QLocale.toTime(string[, format=LongFormat])

Parameters:

• string – str

• format – FormatType

Return type:

PySide2.QtCore.QTime

PySide2.QtCore.QLocale.toUInt(s)

Parameters:

s – str

Return type:

(int, bool ok)

PySide2.QtCore.QLocale.toULong(s[, ok=None])

Parameters:

• s – str

• ok – bool

Return type:

ulong

PySide2.QtCore.QLocale.toULong(s[, ok=None])

Parameters:

• s – QStringRef

• ok – bool

Return type:

ulong

PySide2.QtCore.QLocale.toULongLong(s)

Parameters:

s – str

Return type:

(int, bool ok)

PySide2.QtCore.QLocale.toUShort(s)

Parameters:

s – str

Return type:

(int, bool ok)

PySide2.QtCore.QLocale.toUpper(str)

Parameters:

str – str

Return type:

str

Returns an uppercase copy of str .

If Qt Core is using the ICU libraries, they will be used to perform the transformation according to the rules of the current locale. Otherwise the conversion may be done in a platform-dependent manner, with toUpper() as a generic fallback.

See also

toUpper()

PySide2.QtCore.QLocale.uiLanguages()

Return type:

list of strings

Returns an ordered list of locale names for translation purposes in preference order (like “en-Latn-US”, “en-US”, “en”).

The return value represents locale names that the user expects to see the UI translation in.

Most like you do not need to use this function directly, but just pass the QLocale object to the load() function.

The first item in the list is the most preferred one.

See also

QTranslator bcp47Name()

PySide2.QtCore.QLocale.weekdays()

Return type:

Returns a list of days that are considered weekdays according to the current locale.

PySide2.QtCore.QLocale.zeroDigit()

Return type:

QChar

Returns the zero digit character of this locale.

Note

This function shall change to return a QString instead of QChar in Qt6. Callers are encouraged to exploit the QString ( QChar ) constructor to convert early in preparation for this.

See also

toString()