QLocale#
The QLocale
class converts between numbers and their string representations in various languages. More…
Synopsis#
Functions#
def
amText
()def
bcp47Name
()def
collation
()def
country
()def
createSeparatedList
(strl)def
currencySymbol
([arg__1=QLocale.CurrencySymbolFormat.CurrencySymbol])def
dateFormat
([format=QLocale.FormatType.LongFormat])def
dateTimeFormat
([format=QLocale.FormatType.LongFormat])def
dayName
(arg__1[, format=QLocale.FormatType.LongFormat])def
decimalPoint
()def
exponential
()def
firstDayOfWeek
()def
formattedDataSize
(bytes[, precision=2[, format=QLocale.DataSizeFormat.DataSizeIecFormat]])def
groupSeparator
()def
language
()def
measurementSystem
()def
monthName
(arg__1[, format=QLocale.FormatType.LongFormat])def
name
()def
nativeCountryName
()def
nativeLanguageName
()def
nativeTerritoryName
()def
negativeSign
()def
numberOptions
()def
__ne__
(rhs)def
__eq__
(rhs)def
percent
()def
pmText
()def
positiveSign
()def
quoteString
(str[, style=QLocale.QuotationStyle.StandardQuotation])def
quoteString
(str[, style=QLocale.QuotationStyle.StandardQuotation])def
script
()def
setNumberOptions
(options)def
standaloneDayName
(arg__1[, format=QLocale.FormatType.LongFormat])def
standaloneMonthName
(arg__1[, format=QLocale.FormatType.LongFormat])def
swap
(other)def
territory
()def
textDirection
()def
timeFormat
([format=QLocale.FormatType.LongFormat])def
toCurrencyString
(arg__1[, symbol=””[, precision=-1]])def
toCurrencyString
(i[, symbol=””[, precision=-1]])def
toCurrencyString
(i[, symbol=””])def
toCurrencyString
(arg__1[, symbol=””])def
toDate
(string, format, cal)def
toDate
(string, format)def
toDate
(string, format, cal)def
toDate
(string[, format=QLocale.FormatType.LongFormat])def
toDateTime
(string[, format=QLocale.FormatType.LongFormat])def
toDateTime
(string, format, cal)def
toDateTime
(string, format)def
toDateTime
(string, format, cal)def
toDouble
(s)def
toFloat
(s)def
toInt
(s)def
toLong
(s)def
toLongLong
(s)def
toLower
(str)def
toShort
(s)def
toString
(date, format, cal)def
toString
(i)def
toString
(i)def
toString
(i)def
toString
(f[, format=’g’[, precision=6]])def
toString
(f[, format=’g’[, precision=6]])def
toString
(dateTime, format)def
toString
(dateTime, format, cal)def
toString
(dateTime[, format=QLocale.FormatType.LongFormat])def
toString
(time, format)def
toString
(time[, format=QLocale.FormatType.LongFormat])def
toString
(date, format)def
toString
(date[, format=QLocale.FormatType.LongFormat])def
toTime
(string[, format=QLocale.FormatType.LongFormat])def
toTime
(string, format)def
toUInt
(s)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
codeToCountry
(countryCode)def
codeToLanguage
(languageCode[, codeTypes=QLocale.LanguageCodeType.AnyLanguageCode])def
codeToScript
(scriptCode)def
codeToTerritory
(territoryCode)def
countriesForLanguage
(lang)def
countryToCode
(country)def
countryToString
(country)def
languageToCode
(language[, codeTypes=QLocale.LanguageCodeType.AnyLanguageCode])def
languageToString
(language)def
matchingLocales
(language, script, territory)def
scriptToCode
(script)def
scriptToString
(script)def
setDefault
(locale)def
system
()def
territoryToCode
(territory)def
territoryToString
(territory)
Note
This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE
Detailed Description#
Warning
This section contains snippets that were automatically translated from C++ to Python and may contain errors.
QLocale
is constructed for a specified language, optional script and territory. It offers various facilities for formatting data as text, localized appropriately, and for reading data out of localized text.
Example:
egyptian = QLocale(QLocale.Arabic, QLocale.Egypt) s1 = egyptian.toString(1.571429E+07, 'e') s2 = egyptian.toString(10) d = egyptian.toDouble(s1) 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.
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:
ok = bool() d = float() 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. str = QString("%1 %L2 %L3").arg(12345).arg(12345).arg(12345, 0, 16) # str == "12345 12,345 3039"
An alternative method for constructing a QLocale
object is by specifying the locale name.
korean = QLocale("ko") swiss = QLocale("de_CH")
This constructor reads the language, script and/or territory from the given name, accepting either uderscore or dash as separator (and ignoring any trailing .codeset
or @variant
suffix).
Note
For the current keyboard input locale take a look at QInputMethod::locale().
QLocale
‘s data is based on Common Locale Data Repository v44.1.
Matching combinations of language, script and territory#
QLocale
has data, derived from CLDR, for many combinations of language, script and territory, but not all. If it is constructed with all three of these key values specified (treating AnyLanguage
, AnyScript
or AnyTerritory
as unspecified) and QLocale
has data for the given combination, this data is used. Otherwise, QLocale
does its best to find a sensible combination of language, script and territory, for which it does have data, that matches those that were specified.
The CLDR provides tables of likely combinations, which are used to fill in any unspecified key or keys; if QLocale
has data for the result of such a likely combination, that is used. If no language is specified, and none can be determined from script and territory, or if QLocale
has no data for the language, the “C” locale (when reading the keys from a string) or default locale (otherwise) is used.
When QLocale
has no data for the keys specified, with likely keys filled in where unspecified, but does have data for the resulting language, a fall-back is sought, based on ignoring either territory, script or both (in that order). This results in a QLocale
which may not match what was asked for, but provides localization that’s as suitable as the available data permits, for the keys specified.
Use language()
, script()
and territory()
to determine the actual keys used.
See also
arg()
locale()
- class PySide6.QtCore.QLocale#
PySide6.QtCore.QLocale(language, territory)
PySide6.QtCore.QLocale(language[, script=QLocale.Script.AnyScript[, territory=QLocale.Country.AnyTerritory]])
PySide6.QtCore.QLocale(name)
PySide6.QtCore.QLocale(other)
PySide6.QtCore.QLocale(name)
- Parameters:
name – str
language –
Language
other –
PySide6.QtCore.QLocale
script –
Script
territory –
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
Constructs a QLocale
object for the specified language
and territory
.
If there is more than one script in use for this combination, a likely script will be selected. If QLocale
has no data for the specified language
, the default locale is used. If QLocale
has no data for the specified combination of language
and territory
, an alternative territory may be used instead.
See also
setDefault()
Matching combinations of language, script and territory
Constructs a QLocale
object for the specified language
, script
and territory
.
If QLocale
does not have data for the given combination, it will find data for as good a match as it can. It falls back on the default locale if
language
isAnyLanguage
and no language can be inferred fromscript
andterritory
QLocale
has no data for the language, either given aslanguage
or inferred as above.See also
setDefault()
Matching combinations of language, script and territory
Constructs a QLocale
object with the specified name
.
The name has the format “language[_script][_territory][.codeset][@modifier]” or “C”, where:
language is a lowercase, two-letter, ISO 639 language code (some three-letter codes are also recognized),
script is a capitalized, four-letter, ISO 15924 script code,
territory is an uppercase, two-letter, ISO 3166 territory code (some numeric codes are also recognized), and
codeset and modifier are ignored.
The separator can be either underscore '_'
(U+005F, “low line”) or a dash '-'
(U+002D, “hyphen-minus”). If QLocale
has no data for the specified combination of language, script, and territory, then it uses the most suitable match it can find instead. If the string violates the locale format, or no suitable data can be found for the specified keys, the “C” locale is used instead.
This constructor is much slower than QLocale
(Language, Script, Territory) or QLocale
(Language, Territory).
See also
bcp47Name()
Matching combinations of language, script and territory
Constructs a QLocale
object as a copy of other
.
This is an overloaded function.
- PySide6.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.Akan
QLocale.Akkadian
QLocale.Akoose
QLocale.Albanian
QLocale.AmericanSignLanguage
QLocale.Amharic
QLocale.AncientEgyptian
QLocale.AncientGreek
QLocale.Anii
QLocale.Arabic
QLocale.Aragonese
QLocale.Aramaic
QLocale.Armenian
QLocale.Assamese
QLocale.Asturian
QLocale.Asu
QLocale.Atsam
QLocale.Avaric
QLocale.Avestan
QLocale.Aymara
QLocale.Azerbaijani
QLocale.Bafia
QLocale.Balinese
QLocale.Baluchi
QLocale.Bambara
QLocale.Bamun
QLocale.Bangla
QLocale.Basaa
QLocale.Bashkir
QLocale.Basque
QLocale.BatakToba
QLocale.Belarusian
QLocale.Bemba
QLocale.Bena
QLocale.Bengali
Obsolete, please use Bangla
QLocale.Bhojpuri
QLocale.Bhutani
Obsolete, please use Dzongkha
QLocale.Bislama
QLocale.Blin
QLocale.Bodo
QLocale.Bosnian
QLocale.Breton
QLocale.Buginese
QLocale.Bulgarian
QLocale.Burmese
QLocale.Byelorussian
Obsolete, please use Belarusian
QLocale.Cambodian
Obsolete, please use Khmer
QLocale.Cantonese
QLocale.Catalan
QLocale.Cebuano
QLocale.CentralAtlasTamazight
QLocale.CentralKurdish
QLocale.CentralMoroccoTamazight
Obsolete, please use CentralAtlasTamazight
QLocale.Chakma
QLocale.Chamorro
QLocale.Chechen
QLocale.Cherokee
QLocale.Chewa
Obsolete, please use Nyanja
QLocale.Chickasaw
QLocale.Chiga
QLocale.Chinese
(Mandarin)
QLocale.Church
QLocale.Chuvash
QLocale.Colognian
QLocale.Coptic
QLocale.Cornish
QLocale.Corsican
QLocale.Cree
QLocale.Croatian
QLocale.Czech
QLocale.Danish
QLocale.Divehi
QLocale.Dogri
QLocale.Duala
QLocale.Dutch
QLocale.Dzongkha
QLocale.Embu
QLocale.English
QLocale.Erzya
QLocale.Esperanto
QLocale.Estonian
QLocale.Ewe
QLocale.Ewondo
QLocale.Faroese
QLocale.Fijian
QLocale.Filipino
QLocale.Finnish
QLocale.French
QLocale.Frisian
same as WesternFrisian
QLocale.Friulian
QLocale.Fulah
QLocale.Ga
QLocale.Gaelic
QLocale.Galician
QLocale.Ganda
QLocale.Geez
QLocale.Georgian
QLocale.German
QLocale.Gothic
QLocale.Greek
QLocale.Greenlandic
Obsolete, please use Kalaallisut
QLocale.Guarani
QLocale.Gujarati
QLocale.Gusii
QLocale.Haitian
QLocale.Haryanvi
QLocale.Hausa
QLocale.Hawaiian
QLocale.Hebrew
QLocale.Herero
QLocale.Hindi
QLocale.HiriMotu
QLocale.Hungarian
QLocale.Icelandic
QLocale.Ido
QLocale.Igbo
QLocale.InariSami
QLocale.Indonesian
QLocale.Ingush
QLocale.Interlingua
QLocale.Interlingue
QLocale.Inuktitut
QLocale.Inupiak
Obsolete, please use Inupiaq
QLocale.Inupiaq
QLocale.Irish
QLocale.Italian
QLocale.Japanese
QLocale.Javanese
QLocale.Jju
QLocale.JolaFonyi
QLocale.Kabuverdianu
QLocale.Kabyle
QLocale.Kaingang
QLocale.Kako
QLocale.Kalaallisut
QLocale.Kalenjin
QLocale.Kamba
QLocale.Kangri
QLocale.Kannada
QLocale.Kanuri
QLocale.Kashmiri
QLocale.Kazakh
QLocale.Kenyang
QLocale.Khmer
QLocale.Kiche
QLocale.Kikuyu
QLocale.Kinyarwanda
QLocale.Kirghiz
Obsolete, please use Kyrgyz
QLocale.Komi
QLocale.Kongo
QLocale.Konkani
QLocale.Korean
QLocale.Koro
QLocale.KoyraboroSenni
QLocale.KoyraChiini
QLocale.Kpelle
QLocale.Kuanyama
QLocale.Kurdish
QLocale.Kurundi
Obsolete, please use Rundi
QLocale.Kwanyama
Obsolete, please use Kuanyama
QLocale.Kwasio
QLocale.Kyrgyz
QLocale.Lakota
QLocale.Langi
QLocale.Lao
QLocale.Latin
QLocale.Latvian
QLocale.Lezghian
QLocale.Limburgish
QLocale.Lingala
QLocale.Ligurian
QLocale.LiteraryChinese
QLocale.Lithuanian
QLocale.Lojban
QLocale.LowerSorbian
QLocale.LowGerman
QLocale.LubaKatanga
QLocale.LuleSami
QLocale.Luo
QLocale.Luxembourgish
QLocale.Luyia
QLocale.Macedonian
QLocale.Machame
QLocale.Maithili
QLocale.MakhuwaMeetto
QLocale.Makonde
QLocale.Malagasy
QLocale.Malay
QLocale.Malayalam
QLocale.Maltese
QLocale.Mandingo
QLocale.Manipuri
QLocale.Manx
QLocale.Maori
QLocale.Mapuche
QLocale.Marathi
QLocale.Marshallese
QLocale.Masai
QLocale.Mazanderani
QLocale.Mende
QLocale.Meru
QLocale.Meta
QLocale.Mohawk
QLocale.Moksha
QLocale.Mongolian
QLocale.Morisyen
QLocale.Mundang
QLocale.Muscogee
QLocale.Nama
QLocale.NauruLanguage
QLocale.Navaho
Obsolete, please use Navajo
QLocale.Navajo
QLocale.Ndonga
QLocale.Nepali
QLocale.Newari
QLocale.Ngiemboon
QLocale.Nheengatu
QLocale.NigerianPidgin
QLocale.Ngomba
QLocale.Nko
QLocale.NorthernFrisian
QLocale.NorthernLuri
QLocale.NorthernSami
QLocale.NorthernSotho
QLocale.NorthNdebele
QLocale.NorwegianBokmal
QLocale.NorwegianNynorsk
QLocale.Nuer
QLocale.Nyanja
QLocale.Nyankole
QLocale.Obolo
QLocale.Occitan
QLocale.Odia
QLocale.Ojibwa
QLocale.OldIrish
QLocale.OldNorse
QLocale.OldPersian
QLocale.Oriya
Obsolete, please use Odia
QLocale.Oromo
QLocale.Osage
QLocale.Ossetic
QLocale.Pahlavi
QLocale.Palauan
QLocale.Pali
QLocale.Papiamento
QLocale.Pashto
QLocale.Persian
QLocale.Phoenician
QLocale.Pijin
QLocale.Polish
QLocale.Portuguese
QLocale.Prussian
QLocale.Punjabi
QLocale.Quechua
QLocale.Rajasthani
QLocale.RhaetoRomance
Obsolete, please use Romansh
QLocale.Rohingya
QLocale.Romanian
QLocale.Romansh
QLocale.Rombo
QLocale.Rundi
QLocale.Russian
QLocale.Rwa
QLocale.Saho
QLocale.Sakha
QLocale.Samburu
QLocale.Samoan
QLocale.Sango
QLocale.Sangu
QLocale.Sanskrit
QLocale.Santali
QLocale.Sardinian
QLocale.Saurashtra
QLocale.Sena
QLocale.Serbian
QLocale.Shambala
QLocale.Shona
QLocale.SichuanYi
QLocale.Sicilian
QLocale.Sidamo
QLocale.Silesian
QLocale.Sindhi
QLocale.Sinhala
QLocale.SkoltSami
QLocale.Slovak
QLocale.Slovenian
QLocale.Soga
QLocale.Somali
QLocale.SouthernKurdish
QLocale.SouthernSami
QLocale.SouthernSotho
QLocale.SouthNdebele
QLocale.Spanish
QLocale.StandardMoroccanTamazight
QLocale.Sundanese
QLocale.Swahili
QLocale.Swati
QLocale.Swedish
QLocale.SwissGerman
QLocale.Syriac
QLocale.Tachelhit
QLocale.Tahitian
QLocale.TaiDam
QLocale.Taita
QLocale.Tajik
QLocale.Tamil
QLocale.Taroko
QLocale.Tasawaq
QLocale.Tatar
QLocale.Telugu
QLocale.Teso
QLocale.Thai
QLocale.Tibetan
QLocale.Tigre
QLocale.Tigrinya
QLocale.TokelauLanguage
QLocale.TokiPona
QLocale.TokPisin
QLocale.Tongan
QLocale.Torwali
QLocale.Tsonga
QLocale.Tswana
QLocale.Turkish
QLocale.Turkmen
QLocale.TuvaluLanguage
QLocale.Tyap
QLocale.Ugaritic
QLocale.Uighur
Obsolete, please use Uyghur
QLocale.Uigur
Obsolete, please use Uyghur
QLocale.Ukrainian
QLocale.UpperSorbian
QLocale.Urdu
QLocale.Uyghur
QLocale.Uzbek
QLocale.Vai
QLocale.Venda
QLocale.Venetian
QLocale.Vietnamese
QLocale.Volapuk
QLocale.Vunjo
QLocale.Walamo
Obsolete, please use Wolaytta
QLocale.Walloon
QLocale.Walser
QLocale.Warlpiri
QLocale.Welsh
QLocale.WesternBalochi
QLocale.WesternFrisian
same as Frisian
QLocale.Wolaytta
QLocale.Wolof
QLocale.Xhosa
QLocale.Yangben
QLocale.Yiddish
QLocale.Yoruba
QLocale.Zarma
QLocale.Zhuang
QLocale.Zulu
See also
- PySide6.QtCore.QLocale.Script#
This enumerated type is used to specify a script.
Constant
Description
QLocale.AnyScript
QLocale.AdlamScript
QLocale.AhomScript
QLocale.AnatolianHieroglyphsScript
QLocale.ArabicScript
QLocale.ArmenianScript
QLocale.AvestanScript
QLocale.BalineseScript
QLocale.BamumScript
QLocale.BanglaScript
QLocale.BassaVahScript
QLocale.BatakScript
QLocale.BengaliScript
Obsolete, please use BanglaScript
QLocale.BhaiksukiScript
QLocale.BopomofoScript
QLocale.BrahmiScript
QLocale.BrailleScript
QLocale.BugineseScript
QLocale.BuhidScript
QLocale.CanadianAboriginalScript
QLocale.CarianScript
QLocale.CaucasianAlbanianScript
QLocale.ChakmaScript
QLocale.ChamScript
QLocale.CherokeeScript
QLocale.CopticScript
QLocale.CuneiformScript
QLocale.CypriotScript
QLocale.CyrillicScript
QLocale.DeseretScript
QLocale.DevanagariScript
QLocale.DuployanScript
QLocale.EgyptianHieroglyphsScript
QLocale.ElbasanScript
QLocale.EthiopicScript
QLocale.FraserScript
QLocale.GeorgianScript
QLocale.GlagoliticScript
QLocale.GothicScript
QLocale.GranthaScript
QLocale.GreekScript
QLocale.GujaratiScript
QLocale.GurmukhiScript
QLocale.HangulScript
QLocale.HanifiScript
QLocale.HanScript
QLocale.HanunooScript
QLocale.HanWithBopomofoScript
QLocale.HatranScript
QLocale.HebrewScript
QLocale.HiraganaScript
QLocale.ImperialAramaicScript
QLocale.InscriptionalPahlaviScript
QLocale.InscriptionalParthianScript
QLocale.JamoScript
QLocale.JapaneseScript
QLocale.JavaneseScript
QLocale.KaithiScript
QLocale.KannadaScript
QLocale.KatakanaScript
QLocale.KayahLiScript
QLocale.KharoshthiScript
QLocale.KhmerScript
QLocale.KhojkiScript
QLocale.KhudawadiScript
QLocale.KoreanScript
QLocale.LannaScript
QLocale.LaoScript
QLocale.LatinScript
QLocale.LepchaScript
QLocale.LimbuScript
QLocale.LinearAScript
QLocale.LinearBScript
QLocale.LycianScript
QLocale.LydianScript
QLocale.MahajaniScript
QLocale.MalayalamScript
QLocale.MandaeanScript
QLocale.ManichaeanScript
QLocale.MarchenScript
QLocale.MeiteiMayekScript
QLocale.MendeScript
QLocale.MendeKikakuiScript
Obsolete, please use MendeScript
QLocale.MeroiticCursiveScript
QLocale.MeroiticScript
QLocale.ModiScript
QLocale.MongolianScript
QLocale.MroScript
QLocale.MultaniScript
QLocale.MyanmarScript
QLocale.NabataeanScript
QLocale.NewaScript
QLocale.NewTaiLueScript
QLocale.NkoScript
QLocale.OghamScript
QLocale.OlChikiScript
QLocale.OldHungarianScript
QLocale.OldItalicScript
QLocale.OldNorthArabianScript
QLocale.OldPermicScript
QLocale.OldPersianScript
QLocale.OldSouthArabianScript
QLocale.OdiaScript
QLocale.OriyaScript
Obsolete, please use OdiaScript
QLocale.OrkhonScript
QLocale.OsageScript
QLocale.OsmanyaScript
QLocale.PahawhHmongScript
QLocale.PalmyreneScript
QLocale.PauCinHauScript
QLocale.PhagsPaScript
QLocale.PhoenicianScript
QLocale.PollardPhoneticScript
QLocale.PsalterPahlaviScript
QLocale.RejangScript
QLocale.RunicScript
QLocale.SamaritanScript
QLocale.SaurashtraScript
QLocale.SharadaScript
QLocale.ShavianScript
QLocale.SiddhamScript
QLocale.SignWritingScript
QLocale.SimplifiedChineseScript
same as SimplifiedHanScript
QLocale.SimplifiedHanScript
same as SimplifiedChineseScript
QLocale.SinhalaScript
QLocale.SoraSompengScript
QLocale.SundaneseScript
QLocale.SylotiNagriScript
QLocale.SyriacScript
QLocale.TagalogScript
QLocale.TagbanwaScript
QLocale.TaiLeScript
QLocale.TaiVietScript
QLocale.TakriScript
QLocale.TamilScript
QLocale.TangutScript
QLocale.TeluguScript
QLocale.ThaanaScript
QLocale.ThaiScript
QLocale.TibetanScript
QLocale.TifinaghScript
QLocale.TirhutaScript
QLocale.TraditionalChineseScript
same as TraditionalHanScript
QLocale.TraditionalHanScript
same as TraditionalChineseScript
QLocale.UgariticScript
QLocale.VaiScript
QLocale.VarangKshitiScript
QLocale.YiScript
See also
New in version 4.8.
- PySide6.QtCore.QLocale.Country#
This enumerated type is used to identify a territory.
An individual territory may be a province of a country, a country (by far the most common case) or a larger geographic entity, to which some localization details are specific.
Constant
Description
QLocale.AnyCountry
Osbolete alias for
AnyTerritory
QLocale.AnyTerritory
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
Obsolete, use
BosniaAndHerzegovina
insteadQLocale.BosniaAndHerzegovina
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.CaribbeanNetherlands
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.Curacao
QLocale.CuraSao
Obsolete, use
Curacao
insteadQLocale.Cyprus
QLocale.Czechia
QLocale.CzechRepublic
Obsolete, use
Czechia
insteadQLocale.DemocraticRepublicOfCongo
Obsolete, use
CongoKinshasa
insteadQLocale.DemocraticRepublicOfKorea
Obsolete, use
NorthKorea
insteadQLocale.Denmark
QLocale.DiegoGarcia
QLocale.Djibouti
QLocale.Dominica
QLocale.DominicanRepublic
QLocale.EastTimor
QLocale.Ecuador
QLocale.Egypt
QLocale.ElSalvador
QLocale.EquatorialGuinea
QLocale.Eritrea
QLocale.Estonia
QLocale.Eswatini
QLocale.Ethiopia
QLocale.EuropeanUnion
QLocale.Europe
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
QLocale.Kuwait
QLocale.Kyrgyzstan
QLocale.Laos
QLocale.LatinAmerica
QLocale.LatinAmericaAndTheCaribbean
Obsolete, use
LatinAmerica
insteadQLocale.Latvia
QLocale.Lebanon
QLocale.Lesotho
QLocale.Liberia
QLocale.Libya
QLocale.Liechtenstein
QLocale.Lithuania
QLocale.Luxembourg
QLocale.Macao
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
Osbolete alias for
NauruTerritory
QLocale.NauruTerritory
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
QLocale.Pakistan
QLocale.Palau
QLocale.PalestinianTerritories
QLocale.Panama
QLocale.PapuaNewGuinea
QLocale.Paraguay
QLocale.PeoplesRepublicOfCongo
Obsolete, use
CongoBrazzaville
insteadQLocale.Peru
QLocale.Philippines
QLocale.Pitcairn
QLocale.Poland
QLocale.Portugal
QLocale.PuertoRico
QLocale.Qatar
QLocale.RepublicOfKorea
Obsolete, use
SouthKorea
insteadQLocale.Reunion
QLocale.Romania
QLocale.RussianFederation
QLocale.Russia
QLocale.Rwanda
QLocale.SaintBarthelemy
QLocale.SaintHelena
QLocale.SaintKittsAndNevis
QLocale.SaintLucia
QLocale.SaintMartin
QLocale.SaintPierreAndMiquelon
QLocale.SaintVincentAndGrenadines
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.SouthGeorgiaAndSouthSandwichIslands
QLocale.SouthGeorgiaAndTheSouthSandwichIslands
QLocale.SouthKorea
QLocale.SouthSudan
QLocale.Spain
QLocale.SriLanka
QLocale.Sudan
QLocale.Suriname
QLocale.SvalbardAndJanMayen
QLocale.SvalbardAndJanMayenIslands
QLocale.Swaziland
QLocale.Sweden
QLocale.Switzerland
QLocale.Syria
QLocale.SyrianArabRepublic
Obsolete, use
Syria
insteadQLocale.Taiwan
QLocale.Tajikistan
QLocale.Tanzania
QLocale.Thailand
QLocale.TimorLeste
QLocale.Togo
QLocale.TokelauCountry
Osbolete alias for
TokelauTerritory
QLocale.TokelauTerritory
QLocale.Tonga
QLocale.TrinidadAndTobago
QLocale.TristanDaCunha
QLocale.Tunisia
QLocale.Turkey
QLocale.Turkmenistan
QLocale.TurksAndCaicosIslands
QLocale.TuvaluCountry
Osbolete alias for
TuvaluTerritory
QLocale.TuvaluTerritory
QLocale.Uganda
QLocale.Ukraine
QLocale.UnitedArabEmirates
QLocale.UnitedKingdom
QLocale.UnitedStates
QLocale.UnitedStatesOutlyingIslands
QLocale.UnitedStatesMinorOutlyingIslands
QLocale.UnitedStatesVirginIslands
QLocale.Uruguay
QLocale.Uzbekistan
QLocale.Vanuatu
QLocale.VaticanCity
QLocale.VaticanCityState
QLocale.Venezuela
QLocale.Vietnam
QLocale.WallisAndFutuna
QLocale.WallisAndFutunaIslands
QLocale.WesternSahara
QLocale.World
QLocale.Yemen
QLocale.Zambia
QLocale.Zimbabwe
Note
Use the Territory alias for this enumeration where possible. The Country enum shall be renamed to Territory at a later release.
- PySide6.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 ImperialUSSystem
- PySide6.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
.
- PySide6.QtCore.QLocale.NumberOption#
(inherits enum.Flag
) 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()
FloatingPointPrecisionOption
- PySide6.QtCore.QLocale.FloatingPointPrecisionOption#
(inherits enum.IntEnum
) This enum defines a constant 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. In particular, trailing zeros are omitted (from the mantissa, in exponent formats).
See also
toString()
number()
number()
- PySide6.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.
- PySide6.QtCore.QLocale.DataSizeFormat#
(inherits enum.Flag
) 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
- PySide6.QtCore.QLocale.LanguageCodeType#
(inherits enum.IntFlag
) This enum defines language code types that can be used to restrict set of language codes considered by codeToLanguage
and languageToCode
.
Constant
Description
QLocale.ISO639Part1
ISO 639 Part 1 Alpha 2 code.
QLocale.ISO639Part2B
ISO 639 Part 2 bibliographic Alpha 3 code.
QLocale.ISO639Part2T
ISO 639 Part 2 terminological Alpha 3 code.
QLocale.ISO639Part3
ISO 639 Part 3 Alpha 3 code.
QLocale.LegacyLanguageCode
Codes that are not part of the above set, but that were supported by Qt in the past. This value can only be used by
codeToLanguage()
. It is ignored when passed tolanguageToCode()
.QLocale.ISO639Part2
Any ISO 639 Part 2 code.
QLocale.ISO639Alpha2
Any ISO-639 2-letter code.
QLocale.ISO639Alpha3
Any ISO-639 3-letter code.
QLocale.ISO639
Any ISO 639 code.
QLocale.AnyLanguageCode
Specifies that any code can be used.
New in version 6.3.
- PySide6.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
New in version 4.8.
- PySide6.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
- PySide6.QtCore.QLocale.bcp47Name()#
- Return type:
str
Returns the BCP47 field names joined with dashes.
This combines as many of language, script and territory (and possibly other BCP47 fields) for this locale as are needed to uniquely specify it. Note that fields may be omitted if the Unicode consortium’s Likely Subtag Rules
imply the omitted fields when given those retained. See name()
for how to construct a string from individual fields, if some other format is needed.
Unlike uiLanguages()
, the value returned by bcp47Name() represents the locale name of the QLocale
data; this need not be the language the user-interface should be in.
This function tries to conform the locale name to BCP47.
See also
- static PySide6.QtCore.QLocale.c()#
- Return type:
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
- static PySide6.QtCore.QLocale.codeToCountry(countryCode)#
- Parameters:
countryCode – str
- Return type:
Note
This function is deprecated.
Returns the QLocale::Territory enum corresponding to the two-letter or three-digit countryCode
, as defined in the ISO 3166 standard.
If the code is invalid or not known AnyTerritory
is returned.
Use codeToTerritory
( QStringView
) instead.
- static PySide6.QtCore.QLocale.codeToLanguage(languageCode[, codeTypes=QLocale.LanguageCodeType.AnyLanguageCode])#
- Parameters:
languageCode – str
codeTypes – Combination of
QLocale.LanguageCodeType
- Return type:
Returns the Language
enum corresponding to the two- or three-letter languageCode
, as defined in the ISO 639 standards.
If specified, codeTypes
selects which set of codes to consider for conversion. By default all codes known to Qt are considered. The codes are matched in the following order: ISO639Part1
, ISO639Part2B
, ISO639Part2T
, ISO639Part3
, LegacyLanguageCode
.
If the code is invalid or not known QLocale::AnyLanguage
is returned.
- static PySide6.QtCore.QLocale.codeToScript(scriptCode)#
- Parameters:
scriptCode – str
- Return type:
Returns the Script
enum corresponding to the four-letter script scriptCode
, as defined in the ISO 15924 standard.
If the code is invalid or not known AnyScript
is returned.
- static PySide6.QtCore.QLocale.codeToTerritory(territoryCode)#
- Parameters:
territoryCode – str
- Return type:
Returns the QLocale::Territory enum corresponding to the two-letter or three-digit territoryCode
, as defined in the ISO 3166 standard.
If the code is invalid or not known AnyTerritory
is returned.
- PySide6.QtCore.QLocale.collation()#
- Return type:
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
- static PySide6.QtCore.QLocale.countriesForLanguage(lang)#
- Parameters:
lang –
Language
- Return type:
.list of QLocale.Country
Note
This function is deprecated.
Use matchingLocales()
instead and consult the territory()
of each.
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
Use territory()
instead.
Returns the territory of this locale.
See also
- static PySide6.QtCore.QLocale.countryToCode(country)#
- Parameters:
country –
Country
- Return type:
str
Note
This function is deprecated.
Use territoryToCode()
instead.
Returns the two-letter territory code for country
, as defined in the ISO 3166 standard.
Note
For QLocale::AnyTerritory
or QLocale::AnyCountry
an empty string is returned.
- static PySide6.QtCore.QLocale.countryToString(country)#
- Parameters:
country –
Country
- Return type:
str
Note
This function is deprecated.
Use territoryToString()
instead.
Returns a QString
containing the name of country
.
- PySide6.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.
- PySide6.QtCore.QLocale.currencySymbol([arg__1=QLocale.CurrencySymbolFormat.CurrencySymbol])#
- Parameters:
arg__1 –
CurrencySymbolFormat
- Return type:
str
Returns a currency symbol according to the format
.
- PySide6.QtCore.QLocale.dateFormat([format=QLocale.FormatType.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
- PySide6.QtCore.QLocale.dateTimeFormat([format=QLocale.FormatType.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
- PySide6.QtCore.QLocale.dayName(arg__1[, format=QLocale.FormatType.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
- PySide6.QtCore.QLocale.decimalPoint()#
- Return type:
str
Returns the fractional part separator for this locale.
This is the token that separates the whole number part from the fracional part in the representation of a number which has a fractional part. This is commonly called the “decimal point character” - even though, in many locales, it is not a “point” (or similar dot). It is (since Qt 6.0) returned as a string in case some locale needs more than one UTF-16 code-point to represent its separator.
See also
- PySide6.QtCore.QLocale.exponential()#
- Return type:
str
Returns the exponent separator for this locale.
This is a token used to separate mantissa from exponent in some floating-point numeric representations. It is (since Qt 6.0) returned as a string because, in some locales, it is not a single character - for example, it may consist of a multiplication sign and a representation of the “ten to the power” operator.
See also
toString(double, char, int)
Returns the first day of the week according to the current locale.
- PySide6.QtCore.QLocale.formattedDataSize(bytes[, precision=2[, format=QLocale.DataSizeFormat.DataSizeIecFormat]])#
- Parameters:
bytes – int
precision – int
format – Combination of
QLocale.DataSizeFormat
- 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.
- PySide6.QtCore.QLocale.groupSeparator()#
- Return type:
str
Returns the digit-grouping separator for this locale.
This is a token used to break up long sequences of digits, in the representation of a number, to make it easier to read. In some locales it may be empty, indicating that digits should not be broken up into groups in this way. In others it may be a spacing character. It is (since Qt 6.0) returned as a string in case some locale needs more than one UTF-16 code-point to represent its separator.
See also
Returns the language of this locale.
See also
- static PySide6.QtCore.QLocale.languageToCode(language[, codeTypes=QLocale.LanguageCodeType.AnyLanguageCode])#
- Parameters:
language –
Language
codeTypes – Combination of
QLocale.LanguageCodeType
- Return type:
str
Returns the two- or three-letter language code for language
, as defined in the ISO 639 standards.
If specified, codeTypes
selects which set of codes to consider. The first code from the set that is defined for language
is returned. Otherwise, all ISO-639 codes are considered. The codes are considered in the following order: ISO639Part1
, ISO639Part2B
, ISO639Part2T
, ISO639Part3
. LegacyLanguageCode
is ignored by this function.
Note
For QLocale::C
the function returns "C"
. For QLocale::AnyLanguage
an empty string is returned. If the language has no code in any selected code set, an empty string is returned.
- static PySide6.QtCore.QLocale.languageToString(language)#
- Parameters:
language –
Language
- Return type:
str
Returns a QString
containing the name of language
.
- static PySide6.QtCore.QLocale.matchingLocales(language, script, territory)#
Returns a list of valid locale objects that match the given language
, script
and territory
.
Getting a list of all locales: QList
< QLocale
> allLocales = QLocale::matchingLocales( AnyLanguage
, AnyScript
, AnyTerritory
);
Getting a list of locales suitable for Russia: QList
< QLocale
> locales = QLocale::matchingLocales( AnyLanguage
, AnyScript
, Russia
);
- PySide6.QtCore.QLocale.measurementSystem()#
- Return type:
Returns the measurement system for the locale.
- PySide6.QtCore.QLocale.monthName(arg__1[, format=QLocale.FormatType.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
- PySide6.QtCore.QLocale.name()#
- Return type:
str
The short name of this locale.
Returns the language and territory of this locale as a string of the form “language_territory”, where language is a lowercase, two-letter ISO 639 language code, and territory is an uppercase, two- or three-letter ISO 3166 territory code. If the locale has no specified territory, only the language name is returned.
Even if the QLocale
object was constructed with an explicit script, name() will not contain it for compatibility reasons. Use bcp47Name()
instead if you need a full locale name, or construct the string you want to identify a locale by from those returned by passing its language()
to languageToCode()
and similar for the script and territory.
See also
QLocale()
language()
script()
territory()
bcp47Name()
uiLanguages()
- PySide6.QtCore.QLocale.nativeCountryName()#
- Return type:
str
Note
This function is deprecated.
Use nativeTerritoryName()
instead.
Returns a native name of the territory for the locale. For example “España” for Spanish/Spain locale.
See also
- PySide6.QtCore.QLocale.nativeLanguageName()#
- Return type:
str
Returns a native name of the language for the locale. For example “Schweizer Hochdeutsch” for the Swiss-German locale.
See also
- PySide6.QtCore.QLocale.nativeTerritoryName()#
- Return type:
str
Returns a native name of the territory for the locale. For example “España” for Spanish/Spain locale.
See also
- PySide6.QtCore.QLocale.negativeSign()#
- Return type:
str
Returns the negative sign indicator of this locale.
This is a token presumed to be used as a prefix to a number to indicate that it is negative. It is (since Qt 6.0) returned as a string because, in some locales, it is not a single character - for example, because it includes a text-direction-control character.
See also
- PySide6.QtCore.QLocale.numberOptions()#
- Return type:
Combination of
QLocale.NumberOption
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()
FloatingPointPrecisionOption
- PySide6.QtCore.QLocale.__ne__(rhs)#
- Parameters:
rhs –
PySide6.QtCore.QLocale
- Return type:
bool
Returns true
if the two QLocale
objects, lhs
and rhs
, differ; otherwise returns false
.
Note
The system locale is not equal to the QLocale
object constructed from its language()
, script()
and territory()
, even if the two agree in all data fields. Nor are two locales with different number options equal.
See also
operator==()
setNumberOptions()
- PySide6.QtCore.QLocale.__eq__(rhs)#
- Parameters:
rhs –
PySide6.QtCore.QLocale
- Return type:
bool
Returns true
if the two QLocale
objects, lhs
and rhs
, are the same; otherwise returns false
.
Note
The system locale is not equal to the QLocale
object constructed from its language()
, script()
and territory()
, even if the two agree in all data fields. Nor are two locales with different number options equal.
See also
operator!=()
setNumberOptions()
- PySide6.QtCore.QLocale.percent()#
- Return type:
str
Returns the percent marker of this locale.
This is a token presumed to be appended to a number to indicate a percentage. It is (since Qt 6.0) returned as a string because, in some locales, it is not a single character - for example, because it includes a text-direction-control character.
See also
- PySide6.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
- PySide6.QtCore.QLocale.positiveSign()#
- Return type:
str
Returns the positive sign indicator of this locale.
This is a token presumed to be used as a prefix to a number to indicate that it is positive. It is (since Qt 6.0) returned as a string because, in some locales, it is not a single character - for example, because it includes a text-direction-control character.
See also
- PySide6.QtCore.QLocale.quoteString(str[, style=QLocale.QuotationStyle.StandardQuotation])#
- Parameters:
str – str
style –
QuotationStyle
- Return type:
str
This is an overloaded function.
- PySide6.QtCore.QLocale.quoteString(str[, style=QLocale.QuotationStyle.StandardQuotation])
- Parameters:
str – str
style –
QuotationStyle
- Return type:
str
Returns str
quoted according to the current locale using the given quotation style
.
Returns the script of this locale.
Returns the four-letter script code for script
, as defined in the ISO 15924 standard.
Note
For QLocale::AnyScript
an empty string is returned.
Returns a QString
containing the name of script
.
- static PySide6.QtCore.QLocale.setDefault(locale)#
- Parameters:
locale –
PySide6.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.
- PySide6.QtCore.QLocale.setNumberOptions(options)#
- Parameters:
options – Combination of
QLocale.NumberOption
Sets the options
related to number conversions for this QLocale
instance.
See also
numberOptions()
FloatingPointPrecisionOption
- PySide6.QtCore.QLocale.standaloneDayName(arg__1[, format=QLocale.FormatType.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
- PySide6.QtCore.QLocale.standaloneMonthName(arg__1[, format=QLocale.FormatType.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
- PySide6.QtCore.QLocale.swap(other)#
- Parameters:
other –
PySide6.QtCore.QLocale
Swaps locale other
with this locale. This operation is very fast and never fails.
- static PySide6.QtCore.QLocale.system()#
- Return type:
Returns a QLocale object initialized to the system locale.
The system locale may use system-specific sources for locale data, where available, otherwise falling back on QLocale’s built-in database entry for the language, script and territory the system reports.
For example, on Windows, this locale will use the decimal/grouping characters and date/time formats specified in the system configuration panel.
Note
Qt for Python on macOS will not reflect the user’s region and language preferences though QLocale::system(), but will instead reflect the environment variables POSIX uses to specify locale, similar to Python’s locale module. If the system locale cannot be determined, which can be due to none of the variables ‘LC_ALL’, ‘LC_CTYPE’, ‘LANG’ or ‘LANGUAGE’ being set by your environment, then the default POSIX locale or ‘C’ locale is returned.
See also c().
Returns the territory of this locale.
See also
- static PySide6.QtCore.QLocale.territoryToCode(territory)#
- Parameters:
territory –
Country
- Return type:
str
Returns the two-letter territory code for territory
, as defined in the ISO 3166 standard.
Note
For QLocale::AnyTerritory
an empty string is returned.
- static PySide6.QtCore.QLocale.territoryToString(territory)#
- Parameters:
territory –
Country
- Return type:
str
Returns a QString
containing the name of territory
.
- PySide6.QtCore.QLocale.textDirection()#
- Return type:
Returns the text direction of the language.
- PySide6.QtCore.QLocale.timeFormat([format=QLocale.FormatType.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
- PySide6.QtCore.QLocale.toCurrencyString(arg__1[, symbol=""[, precision=-1]])#
- Parameters:
arg__1 – float
symbol – str
precision – int
- Return type:
str
This function overloads toCurrencyString()
.
Returns a localized string representation of value
as a currency. If the symbol
is provided it is used instead of the default currency symbol. If the precision
is provided it is used to set the precision of the currency value.
See also
- PySide6.QtCore.QLocale.toCurrencyString(i[, symbol=""[, precision=-1]])
- Parameters:
i – float
symbol – str
precision – int
- Return type:
str
This function overloads toCurrencyString()
.
- PySide6.QtCore.QLocale.toCurrencyString(i[, symbol=""])
- Parameters:
i – int
symbol – str
- Return type:
str
This is an overloaded function.
- PySide6.QtCore.QLocale.toCurrencyString(arg__1[, symbol=""])
- Parameters:
arg__1 – int
symbol – str
- Return type:
str
Returns a localized string representation of value
as a currency. If the symbol
is provided it is used instead of the default currency symbol.
See also
- PySide6.QtCore.QLocale.toDate(string, format, cal)#
- Parameters:
string – str
format – str
cal –
PySide6.QtCore.QCalendar
- Return type:
This is an overloaded function.
- PySide6.QtCore.QLocale.toDate(string, format)
- Parameters:
string – str
format – str
- Return type:
Reads string
as a date in the given format
.
Parses string
and returns the date it represents. See fromString()
for the interpretation of format
.
Note
Month and day names, where used, must be given in the locale’s language.
If the date could not be parsed, returns an invalid date.
See also
- PySide6.QtCore.QLocale.toDate(string, format, cal)
- Parameters:
string – str
format –
FormatType
cal –
PySide6.QtCore.QCalendar
- Return type:
This is an overloaded function.
- PySide6.QtCore.QLocale.toDate(string[, format=QLocale.FormatType.LongFormat])
- Parameters:
string – str
format –
FormatType
- Return type:
Reads string
as a date in a locale-specific format
.
Parses string
and returns the date it represents. The format of the date string is chosen according to the format
parameter (see dateFormat()
).
Note
Month and day names, where used, must be given in the locale’s language.
If the date could not be parsed, returns an invalid date.
See also
- PySide6.QtCore.QLocale.toDateTime(string[, format=QLocale.FormatType.LongFormat])#
- Parameters:
string – str
format –
FormatType
- Return type:
Reads string
as a date-time in a locale-specific format
.
Parses string
and returns the date-time it represents. The format of the date string is chosen according to the format
parameter (see dateFormat()
).
Note
Month and day names, where used, must be given in the locale’s language. Any am/pm indicators used must match amText()
or pmText()
, ignoring case.
If the string could not be parsed, returns an invalid QDateTime
.
See also
- PySide6.QtCore.QLocale.toDateTime(string, format, cal)
- Parameters:
string – str
format –
FormatType
cal –
PySide6.QtCore.QCalendar
- Return type:
This is an overloaded function.
- PySide6.QtCore.QLocale.toDateTime(string, format)
- Parameters:
string – str
format – str
- Return type:
Reads string
as a date-time in the given format
.
Parses string
and returns the date-time it represents. See fromString()
for the interpretation of format
.
Note
Month and day names, where used, must be given in the locale’s language. Any am/pm indicators used must match amText()
or pmText()
, ignoring case.
If the string could not be parsed, returns an invalid QDateTime
. If the string can be parsed and represents an invalid date-time (e.g. in a gap skipped by a time-zone transition), an invalid QDateTime
is returned, whose toMSecsSinceEpoch() represents a near-by date-time that is valid. Passing that to fromMSecsSinceEpoch() will produce a valid date-time that isn’t faithfully represented by the string parsed.
See also
- PySide6.QtCore.QLocale.toDateTime(string, format, cal)
- Parameters:
string – str
format – str
cal –
PySide6.QtCore.QCalendar
- Return type:
This is an overloaded function.
- PySide6.QtCore.QLocale.toDouble(s)#
- Parameters:
s – str
- Return type:
(float, bool ok)
Warning
This section contains snippets that were automatically translated from C++ to Python and may contain errors.
Returns the double represented by the localized string s
.
Returns an infinity if the conversion overflows or 0.0 if the conversion fails for any other reason (e.g. underflow).
If ok
is not None
, failure is reported by setting *``ok`` to false
, and success by setting *``ok`` to true
.
ok = bool() d = float() c = QLocale(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 german = QLocale(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
Notice that the last conversion returns 1234.0, because ‘.’ is the thousands group separator in the German locale.
This function ignores leading and trailing whitespace.
See also
- PySide6.QtCore.QLocale.toFloat(s)#
- Parameters:
s – str
- Return type:
(float, bool ok)
Returns the float represented by the localized string s
.
Returns an infinity if the conversion overflows or 0.0 if the conversion fails for any other reason (e.g. underflow).
If ok
is not None
, failure is reported by setting *``ok`` to false
, and success by setting *``ok`` to true
.
This function ignores leading and trailing whitespace.
See also
- PySide6.QtCore.QLocale.toInt(s)#
- Parameters:
s – str
- Return type:
(int, bool ok)
Returns the int represented by the localized string s
.
If the conversion fails the function returns 0.
If ok
is not None
, failure is reported by setting *``ok`` to false
, and success by setting *``ok`` to true
.
This function ignores leading and trailing whitespace.
See also
- PySide6.QtCore.QLocale.toLong(s)#
- Parameters:
s – str
- Return type:
(int, bool ok)
Returns the long int represented by the localized string s
.
If the conversion fails the function returns 0.
If ok
is not None
, failure is reported by setting *``ok`` to false
, and success by setting *``ok`` to true
.
This function ignores leading and trailing whitespace.
See also
- PySide6.QtCore.QLocale.toLongLong(s)#
- Parameters:
s – str
- Return type:
(int, bool ok)
Returns the long long int represented by the localized string s
.
If the conversion fails the function returns 0.
If ok
is not None
, failure is reported by setting *``ok`` to false
, and success by setting *``ok`` to true
.
This function ignores leading and trailing whitespace.
See also
- PySide6.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()
- PySide6.QtCore.QLocale.toShort(s)#
- Parameters:
s – str
- Return type:
(int, bool ok)
Returns the short int represented by the localized string s
.
If the conversion fails the function returns 0.
If ok
is not None
, failure is reported by setting *``ok`` to false
, and success by setting *``ok`` to true
.
This function ignores leading and trailing whitespace.
See also
- PySide6.QtCore.QLocale.toString(date, format, cal)#
- Parameters:
date –
PySide6.QtCore.QDate
format –
FormatType
cal –
PySide6.QtCore.QCalendar
- Return type:
str
Returns a localized string representation of the given date
according to the specified format
(see dateFormat()
), optionally for a specified calendar cal
.
Note
Some locales may use formats that limit the range of years they can represent.
- PySide6.QtCore.QLocale.toString(i)
- Parameters:
i – int
- Return type:
str
Returns a localized string representation of i
.
- PySide6.QtCore.QLocale.toString(i)
- Parameters:
i – int
- Return type:
str
This is an overloaded function.
See also
- PySide6.QtCore.QLocale.toString(i)
- Parameters:
i – int
- Return type:
str
This is an overloaded function.
See also
- PySide6.QtCore.QLocale.toString(f[, format='g'[, precision=6]])
- Parameters:
f – float
format – int
precision – int
- Return type:
str
This is an overloaded function.
Returns a string representing the floating-point number f
.
The format
and precision
have the same meanings as described in toString(double, char, int)
.
See also
toFloat()
toDouble()
numberOptions()
exponential()
decimalPoint()
zeroDigit()
positiveSign()
percent()
toCurrencyString()
formattedDataSize()
FloatingPointPrecisionOption
- PySide6.QtCore.QLocale.toString(f[, format='g'[, precision=6]])
- Parameters:
f – float
format – int
precision – int
- Return type:
str
This is an overloaded function.
Returns a string representing the floating-point number f
.
The form of the representation is controlled by the format
and precision
parameters.
The format
defaults to 'g'
. It can be any of the following:
Format
Meaning
Meaning of
precision
'e'
format as [-]9.9e[+|-]999
number of digits after the decimal point
'E'
format as [-]9.9E[+|-]999
“
'f'
format as [-]9.9
“
'F'
same as
'f'
except for INF and NAN (see below)“
'g'
use
'e'
or'f'
format, whichever is more concisemaximum number of significant digits (trailing zeroes are omitted)
'G'
use
'E'
or'F'
format, whichever is more concise“
The special precision
value FloatingPointShortest
selects the shortest representation that, when read as a number, gets back the original floating-point value. Aside from that, any negative precision
is ignored in favor of the default, 6.
For the 'e'
, 'f'
and 'g'
formats, positive infinity is represented as “inf”, negative infinity as “-inf” and floating-point NaN (not-a-number) values are represented as “nan”. For the 'E'
, 'F'
and 'G'
formats, “INF” and “NAN” are used instead. This does not vary with locale.
See also
toDouble()
numberOptions()
exponential()
decimalPoint()
zeroDigit()
positiveSign()
percent()
toCurrencyString()
formattedDataSize()
FloatingPointPrecisionOption
- PySide6.QtCore.QLocale.toString(dateTime, format)
- Parameters:
dateTime –
PySide6.QtCore.QDateTime
format – str
- Return type:
str
Returns a localized string representation of the given dateTime
according to the specified format
. If format
is an empty string, an empty string is returned.
See also
- PySide6.QtCore.QLocale.toString(dateTime, format, cal)
- Parameters:
dateTime –
PySide6.QtCore.QDateTime
format –
FormatType
cal –
PySide6.QtCore.QCalendar
- Return type:
str
Returns a localized string representation of the given dateTime
according to the specified format
(see dateTimeFormat()
), optionally for a specified calendar cal
.
Note
Some locales may use formats that limit the range of years they can represent.
- PySide6.QtCore.QLocale.toString(dateTime[, format=QLocale.FormatType.LongFormat])
- Parameters:
dateTime –
PySide6.QtCore.QDateTime
format –
FormatType
- Return type:
str
This is an overloaded function.
- PySide6.QtCore.QLocale.toString(time, format)
- Parameters:
time –
PySide6.QtCore.QTime
format – str
- Return type:
str
Returns a localized string representation of the given time
according to the specified format
. If format
is an empty string, an empty string is returned.
See also
- PySide6.QtCore.QLocale.toString(time[, format=QLocale.FormatType.LongFormat])
- Parameters:
time –
PySide6.QtCore.QTime
format –
FormatType
- Return type:
str
Returns a localized string representation of the given time
in the specified format
(see timeFormat()
).
- PySide6.QtCore.QLocale.toString(date, format)
- Parameters:
date –
PySide6.QtCore.QDate
format – str
- Return type:
str
Returns a localized string representation of the given date
in the specified format
. If format
is an empty string, an empty string is returned.
See also
- PySide6.QtCore.QLocale.toString(date[, format=QLocale.FormatType.LongFormat])
- Parameters:
date –
PySide6.QtCore.QDate
format –
FormatType
- Return type:
str
This is an overloaded function.
- PySide6.QtCore.QLocale.toTime(string[, format=QLocale.FormatType.LongFormat])#
- Parameters:
string – str
format –
FormatType
- Return type:
Reads string
as a time in a locale-specific format
.
Parses string
and returns the time it represents. The format of the time string is chosen according to the format
parameter (see timeFormat()
).
If the time could not be parsed, returns an invalid time.
See also
- PySide6.QtCore.QLocale.toTime(string, format)
- Parameters:
string – str
format – str
- Return type:
Reads string
as a time in the given format
.
Parses string
and returns the time it represents. See fromString()
for the interpretation of format
.
If the time could not be parsed, returns an invalid time.
See also
- PySide6.QtCore.QLocale.toUInt(s)#
- Parameters:
s – str
- Return type:
(int, bool ok)
Returns the unsigned int represented by the localized string s
.
If the conversion fails the function returns 0.
If ok
is not None
, failure is reported by setting *``ok`` to false
, and success by setting *``ok`` to true
.
This function ignores leading and trailing whitespace.
See also
- PySide6.QtCore.QLocale.toULong(s[, ok=None])#
- Parameters:
s – str
ok – bool
- Return type:
int
Returns the unsigned long int represented by the localized string s
.
If the conversion fails the function returns 0.
If ok
is not None
, failure is reported by setting *``ok`` to false
, and success by setting *``ok`` to true
.
This function ignores leading and trailing whitespace.
See also
- PySide6.QtCore.QLocale.toULongLong(s)#
- Parameters:
s – str
- Return type:
(int, bool ok)
Returns the unsigned long long int represented by the localized string s
.
If the conversion fails the function returns 0.
If ok
is not None
, failure is reported by setting *``ok`` to false
, and success by setting *``ok`` to true
.
This function ignores leading and trailing whitespace.
See also
- PySide6.QtCore.QLocale.toUShort(s)#
- Parameters:
s – str
- Return type:
(int, bool ok)
Returns the unsigned short int represented by the localized string s
.
If the conversion fails the function returns 0.
If ok
is not None
, failure is reported by setting *``ok`` to false
, and success by setting *``ok`` to true
.
This function ignores leading and trailing whitespace.
See also
- PySide6.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()
- PySide6.QtCore.QLocale.uiLanguages()#
- Return type:
list of strings
List of locale names for use in selecting translations
Each entry in the returned list is the dash-joined name of a locale, suitable to the user’s preferences for what to translate the UI into. For example, if the user has configured their system to use English as used in the USA, the list would be “en-Latn-US”, “en-US”, “en”. The order of entries is the order in which to check for translations; earlier items in the list are to be preferred over later ones.
Most likely you do not need to use this function directly, but just pass the QLocale
object to the load()
function.
See also
- PySide6.QtCore.QLocale.weekdays()#
- Return type:
.list of Qt.DayOfWeek
Returns a list of days that are considered weekdays according to the current locale.
- PySide6.QtCore.QLocale.zeroDigit()#
- Return type:
str
Returns the zero digit character of this locale.
This is a single Unicode character but may be encoded as a surrogate pair, so is (since Qt 6.0) returned as a string. In most locales, other digits follow it in Unicode ordering - however, some number systems, notably those using U+3007 as zero, do not have contiguous digits. Use toString()
to obtain suitable representations of numbers, rather than trying to construct them from this zero digit.
See also