PySide6.QtCore.QLocale¶
- class QLocale¶
QLocale
类在各种语言中转换数字及其字符串表示形式。更多…概要¶
方法¶
def
__init__()
def
amText()
def
bcp47Name()
def
collation()
def
country()
def
currencySymbol()
def
dateFormat()
def
dateTimeFormat()
def
dayName()
def
decimalPoint()
def
exponential()
def
firstDayOfWeek()
def
groupSeparator()
def
language()
def
monthName()
def
name()
def
negativeSign()
def
numberOptions()
def
__ne__()
def
__eq__()
def
percent()
def
pmText()
def
positiveSign()
def
quoteString()
def
script()
def
swap()
def
territory()
def
textDirection()
def
timeFormat()
def
toDate()
def
toDateTime()
def
toDouble()
def
toFloat()
def
toInt()
def
toLong()
def
toLongLong()
def
toLower()
def
toShort()
def
toString()
def
toTime()
def
toUInt()
def
toULong()
def
toULongLong()
def
toUShort()
def
toUpper()
def
uiLanguages()
def
weekdays()
def
zeroDigit()
静态函数¶
def
c()
def
codeToCountry()
def
codeToLanguage()
def
codeToScript()
def
countryToCode()
def
languageToCode()
def
scriptToCode()
def
scriptToString()
def
setDefault()
def
system()
注意
本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题,您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。
详细描述¶
警告
本节包含从C++自动翻译到Python的代码片段,可能包含错误。
QLocale
是为指定的语言、可选的脚本和地区构建的。它提供了各种功能,用于将数据格式化为文本,适当地本地化,并从本地化文本中读取数据。示例:
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
支持默认区域设置的概念,该设置是在应用程序启动时从系统的区域设置中确定的。可以通过调用静态成员setDefault()
来更改默认区域设置。设置默认区域设置有以下效果:如果使用默认构造函数构造一个
QLocale
对象,它将使用默认区域设置的设置。arg()
使用默认的区域设置来格式化数字,当格式字符串中的位置说明符包含 'L' 时,例如 "%L1"。
以下示例说明了如何直接使用
QLocale
: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"
构造
QLocale
对象的另一种方法是指定区域名称。korean = QLocale("ko") swiss = QLocale("de_CH")
此构造函数从给定的名称中读取语言、脚本和/或地区,接受下划线或破折号作为分隔符(并忽略任何尾随的
.codeset
或@variant
后缀)。注意
要查看当前的键盘输入区域设置,请查看 QInputMethod::locale()。
QLocale
的数据基于通用区域数据存储库 v45。匹配语言、文字和地区的组合¶
QLocale
拥有从CLDR派生的数据,涵盖了许多语言、文字和地区的组合,但并非全部。如果它是在指定了这三个关键值的情况下构建的(将AnyLanguage
、AnyScript
或AnyTerritory
视为未指定),并且QLocale
拥有给定组合的数据,则使用此数据。否则,QLocale
会尽力找到一个合理的语言、文字和地区的组合,这些组合它确实有数据,并且与指定的组合相匹配。CLDR 提供了可能的组合表,用于填充任何未指定的键;如果
QLocale
有此类可能组合结果的数据,则使用该数据。如果未指定语言,并且无法从脚本和地区确定语言,或者如果QLocale
没有该语言的数据,则使用“C”区域设置(从字符串读取键时)或默认区域设置(其他情况下)。当
QLocale
没有指定键的数据时,可能会在未指定的地方填充可能的键,但对于结果语言有数据时,会基于忽略地区、脚本或两者(按此顺序)来寻找回退。这导致QLocale
可能不匹配所请求的内容,但为指定的键提供了尽可能适合的本地化,根据可用数据的允许。使用
language()
、script()
和territory()
来确定实际使用的键。另请参阅
arg()
locale()
- class Language¶
此枚举类型用于指定一种语言。
常量
描述
QLocale.AnyLanguage
QLocale.C
一个简化的英语区域设置;参见
c()
QLocale.Abkhazian
QLocale.Afan
已过时,请使用Oromo
QLocale.Afar
QLocale.Afrikaans
QLocale.Aghem
QLocale.Akan
QLocale.Akkadian
QLocale.Akoose
QLocale.Albanian
QLocale.美国手语
QLocale.Amharic
QLocale.古埃及
QLocale.古希腊语
QLocale.Anii
QLocale.Arabic
QLocale.Aragonese
QLocale.Aramaic
QLocale.Armenian
QLocale.阿萨姆语
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
已过时,请使用Bangla
QLocale.Bhojpuri
QLocale.Bhutani
已过时,请使用Dzongkha
QLocale.Bislama
QLocale.Blin
QLocale.Bodo
QLocale.Bosnian
QLocale.Breton
QLocale.Buginese
QLocale.Bulgarian
QLocale.Burmese
QLocale.Byelorussian
已过时,请使用Belarusian
QLocale.Cambodian
已过时,请使用高棉语
QLocale.Cantonese
QLocale.Catalan
QLocale.Cebuano
QLocale.CentralAtlasTamazight
QLocale.CentralKurdish
QLocale.CentralMoroccoTamazight
已过时,请使用CentralAtlasTamazight
QLocale.Chakma
QLocale.Chamorro
QLocale.Chechen
QLocale.Cherokee
QLocale.Chewa
已过时,请使用Nyanja
QLocale.Chickasaw
QLocale.Chiga
QLocale.Chinese
(普通话)
QLocale.Church
QLocale.Chuvash
QLocale.Colognian
QLocale.Coptic
QLocale.Cornish
QLocale.Corsican
QLocale.Cree
QLocale.Croatian
QLocale.Czech
QLocale.丹麦语
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
与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
已过时,请使用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
已过时,请使用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.卡纳达语
QLocale.Kanuri
QLocale.克什米尔语
QLocale.Kazakh
QLocale.Kenyang
QLocale.Khmer
QLocale.Kiche
QLocale.Kikuyu
QLocale.Kinyarwanda
QLocale.Kirghiz
已过时,请使用 Kyrgyz
QLocale.Komi
QLocale.Kongo
QLocale.康卡尼语
QLocale.Korean
QLocale.Koro
QLocale.KoyraboroSenni
QLocale.KoyraChiini
QLocale.Kpelle
QLocale.Kuanyama
QLocale.库尔德语
QLocale.Kurundi
已过时,请使用Rundi
QLocale.Kuvi
QLocale.Kwanyama
已过时,请使用Kuanyama
QLocale.Kwasio
QLocale.Kyrgyz
QLocale.Lakota
QLocale.Langi
QLocale.Lao
QLocale.Latin
QLocale.Latvian
QLocale.Lezghian
QLocale.Limburgish
QLocale.Lingala
QLocale.Ligurian
QLocale.文学中文
QLocale.Lithuanian
QLocale.Lojban
QLocale.LowerSorbian
QLocale.LowGerman
QLocale.LubaKatanga
QLocale.LuleSami
QLocale.Luo
QLocale.卢森堡语
QLocale.Luyia
QLocale.Macedonian
QLocale.Machame
QLocale.Maithili
QLocale.MakhuwaMeetto
QLocale.Makonde
QLocale.Malagasy
QLocale.Malay
QLocale.Malayalam
QLocale.Maltese
QLocale.Mandingo
QLocale.曼尼普尔语
QLocale.Manx
QLocale.毛利语
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
已过时,请使用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
已过时,请使用Odia
QLocale.Oromo
QLocale.Osage
QLocale.Ossetic
QLocale.Pahlavi
QLocale.Palauan
QLocale.Pali
QLocale.Papiamento
QLocale.普什图语
QLocale.Persian
QLocale.Phoenician
QLocale.Pijin
QLocale.Polish
QLocale.Portuguese
QLocale.Prussian
QLocale.Punjabi
QLocale.Quechua
QLocale.Rajasthani
QLocale.RhaetoRomance
已过时,请使用Romansh
QLocale.Rohingya
QLocale.罗马尼亚语
QLocale.罗曼什语
QLocale.Rombo
QLocale.Rundi
QLocale.俄语
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.塔吉克语
QLocale.泰米尔语
QLocale.Taroko
QLocale.Tasawaq
QLocale.Tatar
QLocale.泰卢固语
QLocale.Teso
QLocale.Thai
QLocale.藏语
QLocale.Tigre
QLocale.Tigrinya
QLocale.TokelauLanguage
QLocale.TokiPona
QLocale.TokPisin
汤加语
QLocale.Torwali
QLocale.Tsonga
QLocale.Tswana
QLocale.Turkish
QLocale.Turkmen
QLocale.TuvaluLanguage
QLocale.Tyap
QLocale.Ugaritic
QLocale.Uighur
已过时,请使用Uyghur
QLocale.Uigur
已过时,请使用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
已过时,请使用 Wolaytta
QLocale.Walloon
QLocale.Walser
QLocale.Warlpiri
QLocale.Welsh
QLocale.西俾路支语
QLocale.WesternFrisian
与Frisian相同
QLocale.Wolaytta
QLocale.Wolof
QLocale.Xhosa
QLocale.Yangben
QLocale.Yiddish
QLocale.Yoruba
QLocale.Zarma
QLocale.Zhuang
QLocale.Zulu
- class Script¶
此枚举类型用于指定脚本。
常量
描述
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
已过时,请使用 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.天城文脚本
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
已过时,请使用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
已过时,请使用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
与SimplifiedHanScript相同
QLocale.SimplifiedHanScript
与SimplifiedChineseScript相同
QLocale.SinhalaScript
QLocale.SoraSompengScript
QLocale.SundaneseScript
QLocale.SylotiNagriScript
QLocale.SyriacScript
QLocale.他加禄语脚本
QLocale.TagbanwaScript
QLocale.TaiLeScript
QLocale.TaiVietScript
QLocale.TakriScript
QLocale.TamilScript
QLocale.TangutScript
QLocale.泰卢固语脚本
QLocale.ThaanaScript
QLocale.ThaiScript
QLocale.TibetanScript
QLocale.TifinaghScript
QLocale.TirhutaScript
QLocale.TraditionalChineseScript
与 TraditionalHanScript 相同
QLocale.TraditionalHanScript
与TraditionalChineseScript相同
QLocale.UgariticScript
QLocale.VaiScript
QLocale.VarangKshitiScript
QLocale.YiScript
在版本4.8中添加。
- class Country¶
此枚举类型用于标识一个区域。
一个单独的领土可能是一个国家的省份、一个国家(迄今为止最常见的情况)或一个更大的地理实体,这些实体具有特定的本地化细节。
常量
描述
QLocale.AnyCountry
AnyTerritory
的过时别名QLocale.AnyTerritory
QLocale.阿富汗
QLocale.AlandIslands
QLocale.Albania
QLocale.阿尔及利亚
QLocale.AmericanSamoa
QLocale.安道尔
QLocale.Angola
QLocale.Anguilla
QLocale.Antarctica
QLocale.AntiguaAndBarbuda
QLocale.阿根廷
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
已过时,请使用
BosniaAndHerzegovina
代替QLocale.BosniaAndHerzegovina
QLocale.Botswana
QLocale.BouvetIsland
QLocale.Brazil
QLocale.BritishIndianOceanTerritory
QLocale.BritishVirginIslands
QLocale.Brunei
QLocale.Bulgaria
QLocale.BurkinaFaso
QLocale.Burundi
QLocale.Cambodia
QLocale.喀麦隆
QLocale.Canada
QLocale.CanaryIslands
QLocale.CaribbeanNetherlands
QLocale.CapeVerde
QLocale.CaymanIslands
QLocale.CentralAfricanRepublic
QLocale.CeutaAndMelilla
QLocale.Chad
QLocale.Chile
QLocale.中国
QLocale.圣诞岛
QLocale.ClippertonIsland
QLocale.CocosIslands
QLocale.Colombia
QLocale.科摩罗
QLocale.CongoBrazzaville
QLocale.CongoKinshasa
QLocale.CookIslands
QLocale.CostaRica
QLocale.Croatia
QLocale.Cuba
QLocale.Curacao
QLocale.CuraSao
已过时,请使用
Curacao
代替QLocale.Cyprus
QLocale.Czechia
QLocale.CzechRepublic
已过时,请使用
Czechia
代替QLocale.DemocraticRepublicOfCongo
已过时,请使用
CongoKinshasa
代替QLocale.DemocraticRepublicOfKorea
已过时,请使用
NorthKorea
代替QLocale.丹麦
QLocale.DiegoGarcia
QLocale.吉布提
QLocale.Dominica
QLocale.DominicanRepublic
东帝汶
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.格陵兰
QLocale.Grenada
QLocale.Guadeloupe
QLocale.关岛
QLocale.Guatemala
QLocale.Guernsey
QLocale.Guinea
QLocale.GuineaBissau
QLocale.Guyana
QLocale.Haiti
QLocale.HeardAndMcDonaldIslands
QLocale.Honduras
QLocale.HongKong
QLocale.Hungary
QLocale.Iceland
QLocale.印度
QLocale.印度尼西亚
QLocale.Iran
QLocale.Iraq
QLocale.Ireland
QLocale.IsleOfMan
QLocale.以色列
QLocale.Italy
QLocale.IvoryCoast
QLocale.牙买加
QLocale.Japan
QLocale.Jersey
QLocale.Jordan
QLocale.哈萨克斯坦
QLocale.Kenya
QLocale.Kiribati
QLocale.科索沃
QLocale.Kuwait
QLocale.吉尔吉斯斯坦
QLocale.老挝
QLocale.LatinAmerica
QLocale.LatinAmericaAndTheCaribbean
已过时,请使用
LatinAmerica
代替QLocale.拉脱维亚
QLocale.黎巴嫩
QLocale.Lesotho
QLocale.Liberia
QLocale.Libya
QLocale.列支敦士登
QLocale.立陶宛
QLocale.Luxembourg
QLocale.Macao
QLocale.Macau
QLocale.Macedonia
QLocale.马达加斯加
QLocale.马拉维
QLocale.Malaysia
QLocale.马尔代夫
QLocale.Mali
QLocale.Malta
QLocale.马绍尔群岛
QLocale.马提尼克
QLocale.毛里塔尼亚
QLocale.毛里求斯
QLocale.Mayotte
QLocale.Mexico
QLocale.密克罗尼西亚
QLocale.摩尔多瓦
QLocale.Monaco
QLocale.Mongolia
QLocale.黑山
QLocale.Montserrat
QLocale.摩洛哥
QLocale.莫桑比克
QLocale.Myanmar
QLocale.纳米比亚
QLocale.NauruCountry
NauruTerritory
的过时别名QLocale.NauruTerritory
QLocale.Nepal
QLocale.荷兰
QLocale.NewCaledonia
QLocale.NewZealand
QLocale.尼加拉瓜
QLocale.Niger
QLocale.Nigeria
QLocale.Niue
QLocale.NorfolkIsland
QLocale.NorthernMarianaIslands
QLocale.朝鲜
QLocale.Norway
QLocale.Oman
QLocale.OutlyingOceania
QLocale.Pakistan
QLocale.Palau
QLocale.PalestinianTerritories
QLocale.Panama
QLocale.PapuaNewGuinea
QLocale.Paraguay
QLocale.PeoplesRepublicOfCongo
已过时,请使用
CongoBrazzaville
代替QLocale.Peru
QLocale.菲律宾
QLocale.Pitcairn
QLocale.Poland
QLocale.Portugal
QLocale.PuertoRico
QLocale.卡塔尔
QLocale.RepublicOfKorea
已过时,请使用
SouthKorea
代替QLocale.Reunion
QLocale.罗马尼亚
QLocale.俄罗斯联邦
QLocale.俄罗斯
QLocale.卢旺达
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.斯洛伐克
QLocale.Slovenia
QLocale.SolomonIslands
QLocale.Somalia
QLocale.SouthAfrica
QLocale.SouthGeorgiaAndSouthSandwichIslands
QLocale.SouthGeorgiaAndTheSouthSandwichIslands
QLocale.韩国
QLocale.SouthSudan
QLocale.Spain
QLocale.SriLanka
QLocale.Sudan
QLocale.Suriname
QLocale.SvalbardAndJanMayen
QLocale.SvalbardAndJanMayenIslands
QLocale.斯威士兰
QLocale.瑞典
QLocale.Switzerland
QLocale.Syria
QLocale.SyrianArabRepublic
已过时,请使用
Syria
代替QLocale.台湾
QLocale.塔吉克斯坦
QLocale.坦桑尼亚
QLocale.泰国
QLocale.TimorLeste
QLocale.Togo
QLocale.TokelauCountry
TokelauTerritory
的过时别名QLocale.TokelauTerritory
汤加
QLocale.特立尼达和多巴哥
QLocale.TristanDaCunha
QLocale.突尼斯
QLocale.Turkey
QLocale.Turkmenistan
QLocale.TurksAndCaicosIslands
QLocale.TuvaluCountry
TuvaluTerritory
的过时别名QLocale.TuvaluTerritory
QLocale.Uganda
QLocale.Ukraine
QLocale.阿拉伯联合酋长国
QLocale.英国
QLocale.美国
QLocale.UnitedStatesOutlyingIslands
QLocale.UnitedStatesMinorOutlyingIslands
QLocale.UnitedStatesVirginIslands
QLocale.Uruguay
QLocale.Uzbekistan
QLocale.Vanuatu
QLocale.VaticanCity
QLocale.VaticanCityState
QLocale.Venezuela
QLocale.Vietnam
QLocale.WallisAndFutuna
QLocale.瓦利斯和富图纳群岛
QLocale.西撒哈拉
QLocale.World
QLocale.Yemen
QLocale.赞比亚
QLocale.Zimbabwe
注意
尽可能使用Territory别名来表示此枚举。Country枚举将在以后的版本中更名为Territory。
- class MeasurementSystem¶
此枚举定义了用于测量的单位。
常量
描述
QLocale.MetricSystem
该值表示公制单位,例如米、厘米和毫米。
QLocale.ImperialUSSystem
此值表示在美国使用的英制单位,例如英寸和英里。
QLocale.ImperialUKSystem
该值表示在英国使用的英制单位,例如英寸和英里。
QLocale.ImperialSystem
为兼容性提供。与ImperialUSSystem相同
- class FormatType¶
此枚举描述了将
QDate
、QTime
和QDateTime
对象以及月份和日期转换为特定于区域设置的字符串时可以使用的不同格式。常量
描述
QLocale.LongFormat
较长的格式。
QLocale.ShortFormat
较短的格式。
QLocale.NarrowFormat
当空间非常有限时使用的特殊版本。
注意
NarrowFormat
可能包含不同月份和日期的相同文本。如果区域设置不支持窄名称,它甚至可能是一个空字符串,因此您应避免将其用于日期格式化。此外,对于系统区域设置,此格式与ShortFormat
相同。
- class NumberOption¶
(继承自
enum.Flag
)此枚举定义了一组用于数字到字符串和字符串到数字转换的选项。可以通过numberOptions()
获取这些选项,并通过setNumberOptions()
进行设置。常量
描述
QLocale.DefaultNumberOptions
此选项表示默认行为,带有分组分隔符,在单数字指数中带有一个前导零,并且在小数点后没有尾随零。
QLocale.OmitGroupSeparator
如果设置了此选项,数字到字符串的函数将不会在其返回值中插入组分隔符。默认情况下会插入组分隔符。
QLocale.RejectGroupSeparator
如果设置了此选项,字符串到数字的函数在输入中遇到组分隔符时将失败。默认情况下是接受包含正确放置的组分隔符的数字。
QLocale.OmitLeadingZeroInExponent
如果设置了此选项,数字转字符串函数在科学计数法中打印浮点数时不会用零填充指数。默认情况下,会为单个数字的指数添加一个前导零。
QLocale.RejectLeadingZeroInExponent
如果设置了此选项,字符串到数字的函数在解析科学计数法中的浮点数时,如果遇到用零填充的指数,将会失败。默认是接受这种填充。
QLocale.IncludeTrailingZeroesAfterDot
如果设置了此选项,数字转字符串函数将在“g”或“最简洁”模式下用零填充数字以达到请求的精度,即使有效数字的数量低于请求的精度。默认情况下会省略尾随零。
QLocale.RejectTrailingZeroesAfterDot
如果设置了此选项,字符串到数字的函数在解析科学或十进制表示的数字时,如果遇到小数点后的尾随零,将会失败。默认是接受尾随零。
- class FloatingPointPrecisionOption¶
(继承自
enum.IntEnum
)此枚举定义了一个常量,可以在将浮点数或双精度数转换为number()
、number()
和toString()
时作为精度给出,以表示可变数量的数字作为精度。常量
描述
QLocale.FloatingPointShortest
转换算法将尝试为给定数字找到最短的准确表示。“准确”意味着你可以从生成的字符串表示的逆转换中获取完全相同的数字。特别是,尾随零将被省略(在指数格式中,从尾数中省略)。
另请参阅
toString()
number()
number()
- class TagSeparator¶
指示如何组合构成区域设置标识符的各个部分。
区域标识符可能由多个标签组成,表示语言、文字和地区(可能还包括其他细节),这些标签连接在一起形成标识符。各种标准和常规形式使用破折号(Unicode的HYPHEN-MINUS,U+002D)或下划线(LOW LINE,U+005F)。因此,
QLocale
的不同客户端可能需要其中一种或另一种。常量
描述
QLocale.TagSeparator.Dash
使用
'-'
,即破折号或连字符。QLocale.TagSeparator.Underscore
使用
'_'
,下划线字符。注意
尽管破折号和下划线是公共标准中唯一使用的分隔符(截至2023年),但如果需要非标准的ASCII分隔符,可以将任何ASCII字符转换为这种类型。不支持转换非ASCII字符(十进制值大于127):这些值保留用于将来作为枚举成员使用,如果某些公共标准使用非ASCII分隔符。当然,可以使用
replace()
来替换使用此类型参数的函数所使用的分隔符为任意Unicode字符或字符串。在版本6.7中添加。
- class CurrencySymbolFormat¶
指定货币符号的格式。
常量
描述
QLocale.CurrencyIsoCode
货币的ISO-4217代码。
QLocale.CurrencySymbol
货币符号。
QLocale.CurrencyDisplayName
货币的用户可读名称。
在版本4.8中添加。
- class DataSizeFormat¶
(继承自
enum.Flag
) 指定数据量表示的格式。常量
描述
QLocale.DataSizeIecFormat
使用1024为基数和IEC前缀进行格式化:KiB, MiB, GiB, …
QLocale.DataSizeTraditionalFormat
使用1024为基数和SI前缀进行格式化:kB, MB, GB, …
QLocale.DataSizeSIFormat
使用基数1000和SI前缀格式化:kB, MB, GB, …
另请参阅
- class LanguageCodeType¶
(继承自
enum.IntFlag
) 此枚举定义了可用于限制codeToLanguage
和languageToCode
所考虑的语言代码集合的语言代码类型。常量
描述
QLocale.ISO639Part1
ISO 639 第1部分 Alpha 2 代码。
QLocale.ISO639Part2B
ISO 639 第2部分书目 Alpha 3 代码。
QLocale.ISO639Part2T
ISO 639 第 2 部分术语 Alpha 3 代码。
QLocale.ISO639Part3
ISO 639 第3部分 Alpha 3 代码。
QLocale.LegacyLanguageCode
不属于上述集合的代码,但过去由Qt支持。此值只能由
codeToLanguage()
使用。当传递给languageToCode()
时,它将被忽略。QLocale.ISO639Part2
任何ISO 639第2部分代码。
QLocale.ISO639Alpha2
任何ISO-639 2字母代码。
QLocale.ISO639Alpha3
任何ISO-639 3字母代码。
QLocale.ISO639
任何ISO 639代码。
QLocale.AnyLanguageCode
指定可以使用任何代码。
在版本6.3中添加。
- class QuotationStyle¶
此枚举定义了一组可能的样式,用于特定于地区的引号。
常量
描述
QLocale.StandardQuotation
如果设置了此选项,将使用标准引号来引用字符串。
QLocale.AlternateQuotation
如果设置了此选项,将使用替代引号来引用字符串。
另请参阅
在版本4.8中添加。
- PySide6.QtCore.QLocale.DefaultTwoDigitBaseYear¶
- __init__()¶
构造一个使用默认区域设置初始化的
QLocale
对象。如果没有使用
setDefault()
设置默认区域设置,则此区域设置将与system()
返回的区域设置相同。另请参阅
- __init__(name)
- Parameters:
name – str
使用指定的
name
构造一个QLocale
对象。名称的格式为“语言[_脚本][_地区][.编码集][@修饰符]”或“C”,其中:
language 是一个小写的、两个字母的 ISO 639 语言代码(某些三个字母的代码也被识别),
script 是一个大写的、四个字母的 ISO 15924 脚本代码,
territory 是一个大写的、两个字母的 ISO 3166 地区代码(也识别一些数字代码),并且
codeset 和 modifier 被忽略。
分隔符可以是下划线
'_'
(U+005F, “低线”) 或破折号'-'
(U+002D, “减号”)。如果QLocale
没有指定语言、脚本和地区组合的数据,则它会使用能找到的最合适的匹配项。如果字符串违反区域设置格式,或者找不到指定键的合适数据,则使用“C”区域设置。这个构造函数比
QLocale
(Language, Script, Territory) 或QLocale
(Language, Territory) 慢得多。另请参阅
bcp47Name()
匹配 语言、 脚本 和 地区的 组合
- __init__(other)
- Parameters:
其他 –
QLocale
构造一个
QLocale
对象作为other
的副本。- __init__(name)
- Parameters:
name – str
这是一个重载函数。
为指定的
language
和territory
构造一个QLocale
对象。如果此组合使用了多个脚本,将选择一个可能的脚本。如果
QLocale
没有指定language
的数据,则使用默认的区域设置。如果QLocale
没有指定language
和territory
组合的数据,则可能会使用替代的territory。另请参阅
setDefault()
匹配 语言、 脚本 和 地区的 组合
- __init__(language[, script=QLocale.Script.AnyScript[, territory=QLocale.Country.AnyTerritory]])
为指定的
language
、script
和territory
构造一个QLocale
对象。如果
QLocale
没有给定组合的数据,它将尽可能找到最佳匹配的数据。如果没有找到,它将回退到默认的区域设置。language
是AnyLanguage
,并且无法从script
和territory
推断出语言QLocale
没有该语言的数据,无论是作为language
给出还是如上所述推断。
另请参阅
setDefault()
匹配 语言、 脚本 和 地区的 组合
- amText()¶
- Return type:
字符串
返回使用12小时制约定指定的时间的“上午”后缀的本地化名称。
另请参阅
- bcp47Name([separator=QLocale.TagSeparator.Dash])¶
- Parameters:
分隔符 –
TagSeparator
- Return type:
字符串
返回用破折号连接的BCP47字段名称。
这结合了尽可能多的语言、脚本和地区(以及可能的其他BCP47字段)来唯一指定此区域设置。请注意,如果Unicode联盟的
Likely Subtag Rules
在给定保留字段时暗示了省略的字段,则可以省略这些字段。如果需要其他格式,请参阅name()
以了解如何从各个字段构造字符串。与
uiLanguages()
不同,bcp47Name()返回的值表示QLocale
数据的区域设置名称;这不一定是用户界面应该使用的语言。此函数尝试将区域设置名称符合IETF最佳通用实践47,由RFC 5646定义。自Qt 6.7起,它支持一个可选的
separator
参数,该参数可用于覆盖BCP47指定的使用连字符来分隔标签的用法。然而,在IETF定义的协议中使用时,应保留默认的Dash
。返回一个初始化为“C”区域设置的
QLocale
对象。此区域设置基于en_US,但具有其自身的各种特点,例如简化的数字格式和其自己的日期格式。它实现了描述“C”编程语言标准库函数行为的POSIX标准。
除此之外,这意味着其排序顺序基于字母的ASCII值,因此(对于区分大小写的排序)所有大写字母在任何小写字母之前排序(而不是每个字母的大写和小写形式相邻排序,然后再是下一个字母的两种形式)。
另请参阅
返回与ISO 3166标准中定义的两个字母或三位数字
countryCode
对应的QLocale::Territory枚举。如果代码无效或未知,则返回
AnyTerritory
。请使用
codeToTerritory
(QStringView
) 代替。- static codeToLanguage(languageCode[, codeTypes=QLocale.LanguageCodeType.AnyLanguageCode])¶
- Parameters:
languageCode – str
codeTypes –
LanguageCodeType
的组合
- Return type:
返回与ISO 639标准中定义的两字母或三字母
languageCode
对应的Language
枚举。如果指定了
codeTypes
,则选择要考虑转换的代码集。默认情况下,Qt已知的所有代码都会被考虑。代码按以下顺序匹配:ISO639Part1
、ISO639Part2B
、ISO639Part2T
、ISO639Part3
、LegacyLanguageCode
。如果代码无效或未知,则返回
QLocale::AnyLanguage
。返回与四字母脚本代码
scriptCode
对应的Script
枚举,如ISO 15924标准中所定义。如果代码无效或未知,则返回
AnyScript
。返回与ISO 3166标准中定义的两个字母或三位数字
territoryCode
对应的QLocale::Territory枚举。如果代码无效或未知,则返回
AnyTerritory
。返回用于排序的区域设置。
结果通常是这个区域设置;然而,系统区域设置(通常是默认区域设置)将返回系统排序区域设置。结果适合传递给
QCollator
的构造函数。另请参阅
使用
matchingLocales()
代替,并查阅每个的territory()
。返回在Qt的区域设置数据库中有
language
条目的国家列表。如果结果为空列表,则表示language
在Qt的区域设置数据库中未表示。另请参阅
请使用
territory()
代替。返回此区域设置的地区。
请使用
territoryToCode()
代替。返回
country
的两个字母的领土代码,如ISO 3166标准中所定义。注意
对于
QLocale::AnyTerritory
或QLocale::AnyCountry
,将返回一个空字符串。请使用
territoryToString()
代替。返回一个包含
country
名称的QString
。- createSeparatedList(strl)¶
- Parameters:
strl – 字符串列表
- Return type:
字符串
返回一个字符串,该字符串表示使用由区域设置定义的分隔符连接的给定
list
字符串列表。- currencySymbol([format=QLocale.CurrencySymbolFormat.CurrencySymbol])¶
- Parameters:
format –
CurrencySymbolFormat
- Return type:
字符串
根据
format
返回一个货币符号。- dateFormat([format=QLocale.FormatType.LongFormat])¶
- Parameters:
格式 –
FormatType
- Return type:
字符串
返回用于当前区域设置的日期格式。
如果
format
是LongFormat
,格式将会是详细的,否则将会是简短的。例如,对于en_US
区域设置,LongFormat
是dddd, MMMM d, yyyy
,ShortFormat
是M/d/yy
。另请参阅
- dateTimeFormat([format=QLocale.FormatType.LongFormat])¶
- Parameters:
格式 –
FormatType
- Return type:
字符串
返回用于当前区域设置的日期时间格式。
如果
format
是LongFormat
,格式将会是详细的,否则将会是简短的。例如,对于en_US
区域设置,LongFormat
是dddd, MMMM d, yyyy h:mm:ss AP t
,ShortFormat
是M/d/yy h:mm AP
。另请参阅
- dayName(day[, format=QLocale.FormatType.LongFormat])¶
- Parameters:
day – 整数
format –
FormatType
- Return type:
字符串
返回
day
的本地化名称(其中1代表星期一,2代表星期二,依此类推),格式由type
指定。例如,如果区域设置为
en_US
且day
为1,LongFormat
将返回Monday
,ShortFormat
返回Mon
,而NarrowFormat
返回M
。- decimalPoint()¶
- Return type:
字符串
返回此语言环境的小数部分分隔符。
这是在有小数部分的数字表示中,将整数部分与小数部分分隔开的标记。这通常被称为“小数点字符”——尽管在许多地区,它并不是一个“点”(或类似的点)。自Qt 6.0起,它被返回为一个字符串,以防某些地区需要多个UTF-16代码点来表示其分隔符。
- exponential()¶
- Return type:
字符串
返回此区域设置的指数分隔符。
这是一个用于在某些浮点数表示中将尾数与指数分开的标记。自Qt 6.0起,它作为字符串返回,因为在某些区域设置中,它不是一个单一字符——例如,它可能由一个乘号和一个“十的幂”运算符的表示组成。
另请参阅
toString(double, char, int)
根据当前区域设置返回一周的第一天。
- formattedDataSize(bytes[, precision=2[, format=QLocale.DataSizeFormat.DataSizeIecFormat]])¶
- Parameters:
bytes – int
precision – int
format –
DataSizeFormat
的组合
- Return type:
字符串
将字节大小转换为人类可读的本地化字符串,包括一个数字和一个量化的单位。选择量词使得数字至少为一,并且尽可能小。例如,如果
bytes
是16384,precision
是2,format
是DataSizeIecFormat
(默认值),此函数返回“16.00 KiB”;对于1330409069609字节,它返回“1.21 GiB”;依此类推。如果format
是DataSizeIecFormat
或DataSizeTraditionalFormat
,给定的字节数除以1024的幂,结果小于1024;对于DataSizeSIFormat
,它除以1000的幂,结果小于1000。DataSizeIecFormat
使用新的IEC标准量词Ki、Mi等,而DataSizeSIFormat
使用旧的SI量词k、M等,DataSizeTraditionalFormat
则滥用它们。- groupSeparator()¶
- Return type:
字符串
返回此区域设置的数字分组分隔符。
这是一个用于在数字表示中分隔长数字序列的标记,以便更容易阅读。在某些区域设置中,它可能为空,表示不应以这种方式将数字分组。在其他区域设置中,它可能是一个空格字符。自Qt 6.0起,它作为字符串返回,以防某些区域设置需要多个UTF-16代码点来表示其分隔符。
另请参阅
返回此区域设置的语言。
- static languageToCode(language[, codeTypes=QLocale.LanguageCodeType.AnyLanguageCode])¶
- Parameters:
language –
语言
codeTypes –
LanguageCodeType
的组合
- Return type:
字符串
返回
language
的两字母或三字母语言代码,如ISO 639标准中所定义。如果指定了
codeTypes
,则选择要考虑的代码集。返回为language
定义的集合中的第一个代码。否则,将考虑所有ISO-639代码。代码按以下顺序考虑:ISO639Part1
、ISO639Part2B
、ISO639Part2T
、ISO639Part3
。LegacyLanguageCode
被此函数忽略。注意
对于
QLocale::C
,函数返回"C"
。对于QLocale::AnyLanguage
,返回一个空字符串。如果语言在任何选定的代码集中没有代码,则返回一个空字符串。返回一个包含
language
名称的QString
。- static matchingLocales(language, script, territory)¶
返回与给定的
language
、script
和territory
匹配的有效区域设置对象的列表。获取所有区域设置的列表:
QList
<QLocale
> allLocales = QLocale::matchingLocales(AnyLanguage
,AnyScript
,AnyTerritory
);获取适合俄罗斯的区域设置列表:
QList
<QLocale
> locales = QLocale::matchingLocales(AnyLanguage
,AnyScript
,Russia
);- measurementSystem()¶
- Return type:
返回区域设置的测量系统。
- monthName(month[, format=QLocale.FormatType.LongFormat])¶
- Parameters:
month – 整数
format –
FormatType
- Return type:
字符串
返回
month
的本地化名称,格式由type
指定。例如,如果区域设置为
en_US
且month
为1,LongFormat
将返回January
。ShortFormat
Jan
,以及NarrowFormat
J
。- name([separator=QLocale.TagSeparator.Underscore])¶
- Parameters:
分隔符 –
TagSeparator
- Return type:
字符串
此区域设置的简称。
返回此区域设置的语言和地区,格式为“language_territory”的字符串,其中language是小写的两个字母的ISO 639语言代码,territory是大写的两个或三个字母的ISO 3166地区代码。如果区域设置没有指定地区,则只返回语言名称。自Qt 6.7起,可以提供一个可选的
separator
参数来覆盖默认的下划线字符,该字符用于分隔两个标签。即使
QLocale
对象是用显式脚本构造的,出于兼容性原因,name()也不会包含它。如果需要完整的区域设置名称,请使用bcp47Name()
,或者通过将其language()
传递给languageToCode()
以及类似的脚本和区域来构造您想要标识的区域设置字符串。另请参阅
QLocale()
language()
script()
territory()
bcp47Name()
uiLanguages()
- nativeCountryName()¶
- Return type:
字符串
注意
此函数已弃用。
请使用
nativeTerritoryName()
代替。返回该地区的本地名称。例如,西班牙/西班牙地区的名称为“España”。
- nativeLanguageName()¶
- Return type:
字符串
返回语言环境的本地语言名称。例如,瑞士德语语言环境的“Schweizer Hochdeutsch”。
- nativeTerritoryName()¶
- Return type:
字符串
返回该地区的本地名称。例如,西班牙/西班牙地区的名称为“España”。
- negativeSign()¶
- Return type:
字符串
返回此区域设置的负号指示符。
这是一个假定用作数字前缀以表示其为负数的标记。自Qt 6.0起,它作为字符串返回,因为在某些区域设置中,它不是一个单一字符——例如,因为它包含一个文本方向控制字符。
另请参阅
- numberOptions()¶
- Return type:
NumberOption
的组合
返回与此
QLocale
实例相关的数字转换选项。默认情况下,标准区域设置没有设置任何选项,除了“C”区域设置,它默认设置了
OmitGroupSeparator
。如果两个
QLocale
对象lhs
和rhs
不同,则返回true
;否则返回false
。注意
系统区域设置不等于从其
language()
、script()
和territory()
构造的QLocale
对象,即使两者在所有数据字段中都一致。具有不同数字选项的两个区域设置也不相等。另请参阅
operator==()
setNumberOptions()
- __ne__(lhs)
- Parameters:
lhs –
语言
- Return type:
布尔
- __ne__(rhs)
- Parameters:
rhs –
语言
- Return type:
布尔
如果两个
QLocale
对象lhs
和rhs
相同,则返回true
;否则返回false
。注意
系统区域设置不等于从其
language()
、script()
和territory()
构造的QLocale
对象,即使两者在所有数据字段中都一致。具有不同数字选项的两个区域设置也不相等。另请参阅
operator!=()
setNumberOptions()
- __eq__(lhs)
- Parameters:
lhs –
语言
- Return type:
布尔
- __eq__(rhs)
- Parameters:
rhs –
语言
- Return type:
布尔
- percent()¶
- Return type:
字符串
返回此区域设置的百分比标记。
这是一个假定附加在数字后面以表示百分比的标记。自Qt 6.0起,它作为字符串返回,因为在某些语言环境中,它不是一个单一字符——例如,因为它包含一个文本方向控制字符。
另请参阅
- pmText()¶
- Return type:
字符串
返回使用12小时制约定指定的时间的“PM”后缀的本地化名称。
另请参阅
- positiveSign()¶
- Return type:
字符串
返回此区域设置的正号指示符。
这是一个假定用作数字前缀以表示其为正数的标记。自Qt 6.0起,它作为字符串返回,因为在某些区域设置中,它不是一个单一字符——例如,因为它包含一个文本方向控制字符。
另请参阅
- quoteString(str[, style=QLocale.QuotationStyle.StandardQuotation])¶
- Parameters:
str – str
style –
QuotationStyle
- Return type:
字符串
这是一个重载函数。
- quoteString(str[, style=QLocale.QuotationStyle.StandardQuotation])
- Parameters:
str – str
style –
QuotationStyle
- Return type:
字符串
根据当前区域设置,使用给定的引用
style
返回str
的引用形式。返回此区域设置的脚本。
返回
script
的四字母脚本代码,如ISO 15924标准中所定义。注意
对于
QLocale::AnyScript
,返回一个空字符串。返回一个包含
script
名称的QString
。将全局默认区域设置设置为
locale
。当QLocale
对象在没有参数的情况下构造时,将使用这些值。如果未调用此函数,则使用系统的区域设置。- setNumberOptions(options)¶
- Parameters:
options –
NumberOption
的组合
设置与此
QLocale
实例相关的数字转换options
。- standaloneDayName(day[, format=QLocale.FormatType.LongFormat])¶
- Parameters:
day – 整数
format –
FormatType
- Return type:
字符串
返回
day
的本地化名称(其中1代表星期一,2代表星期二,依此类推),该名称用作独立文本,格式由type
指定。如果区域设置信息未指定独立的日期名称,则返回值与
dayName()
中的相同。- standaloneMonthName(month[, format=QLocale.FormatType.LongFormat])¶
- Parameters:
month – 整数
format –
FormatType
- Return type:
字符串
返回用作独立文本的
month
的本地化名称,格式由type
指定。如果区域设置信息未指定独立的月份名称,则返回值与
monthName()
中的相同。将本地化设置
other
与此本地化设置交换。此操作非常快速且永远不会失败。返回一个初始化为系统区域设置的QLocale对象。
系统区域设置可能会使用系统特定的来源来获取区域数据,如果可用的话,否则会回退到QLocale的内置数据库条目,该条目对应于系统报告的语言、文字和地区。
例如,在Windows上,此区域设置将使用系统配置面板中指定的小数/分组字符和日期/时间格式。
注意
在macOS上,Qt for Python不会通过QLocale::system()反映用户的区域和语言偏好,而是会反映POSIX用于指定区域设置的环境变量,类似于Python的locale模块。如果无法确定系统区域设置,可能是由于您的环境没有设置变量'LC_ALL'、'LC_CTYPE'、'LANG'或'LANGUAGE',那么将返回默认的POSIX区域设置或'C'区域设置。
另请参见 c()。
返回此区域设置的地区。
返回
territory
的两个字母的地区代码,该代码定义在ISO 3166标准中。注意
对于
QLocale::AnyTerritory
,返回一个空字符串。返回一个包含
territory
名称的QString
。- textDirection()¶
- Return type:
返回语言的文本方向。
- timeFormat([format=QLocale.FormatType.LongFormat])¶
- Parameters:
格式 –
FormatType
- Return type:
字符串
返回用于当前区域设置的时间格式。
如果
format
是LongFormat
,格式将会是详细的,否则将会是简短的。例如,对于en_US
区域设置,LongFormat
是h:mm:ss AP t
,ShortFormat
是h:mm AP
。另请参阅
- toCurrencyString(i[, symbol=""])¶
- Parameters:
i – 整数
symbol – str
- Return type:
字符串
这是一个重载函数。
- toCurrencyString(value[, symbol=""])
- Parameters:
value – int
symbol – str
- Return type:
字符串
返回
value
作为货币的本地化字符串表示。如果提供了symbol
,则使用它代替默认的货币符号。另请参阅
- toCurrencyString(value[, symbol=""[, precision=-1]])
- Parameters:
value – 浮点数
symbol – str
precision – int
- Return type:
字符串
此函数重载了
toCurrencyString()
。返回
value
作为货币的本地化字符串表示。如果提供了symbol
,则使用它代替默认的货币符号。如果提供了precision
,则使用它来设置货币值的精度。另请参阅
- toCurrencyString(i[, symbol=""[, precision=-1]])
- Parameters:
i – 浮点数
symbol – str
precision – int
- Return type:
字符串
此函数重载了
toCurrencyString()
。- toDate(string[, format=QLocale.FormatType.LongFormat[, baseYear=1900]])¶
- Parameters:
字符串 – str
format –
FormatType
baseYear – int
- Return type:
将
string
读取为特定语言环境的format
中的日期。解析
string
并返回其表示的日期。日期字符串的格式根据format
参数选择(参见dateFormat()
)。一些地区,特别是对于
ShortFormat
,只使用年份的最后两位数字。在这种情况下,从baseYear
开始的100年是首先考虑的候选。在6.7版本之前,没有baseYear
参数,总是使用1900年。这是baseYear
的默认值,从那时到1999年选择一个年份。在某些情况下,其他字段可能会导致选择下一个或上一个世纪,以获得与所有给定字段一致的结果。详情请参见fromString()
。注意
月份和日期的名称,在使用时,必须使用本地语言。
如果日期无法解析,则返回一个无效日期。
- toDate(string, format[, baseYear=1900])
- Parameters:
字符串 – str
format – str
baseYear – int
- Return type:
将
string
读取为给定format
格式的日期。解析
string
并返回其表示的日期。有关format
的解释,请参见fromString()
。当
format
仅指定年份的最后两位数字时,首先考虑的是从baseYear
开始的100年。在6.7版本之前,没有baseYear
参数,总是使用1900年。这是baseYear
的默认值,从那时到1999年之间选择一个年份。在某些情况下,其他字段可能会导致选择下一个或上一个世纪,以获得与所有给定字段一致的结果。详情请参见fromString()
。注意
月份和日期的名称,在使用时,必须使用本地语言。
如果日期无法解析,则返回一个无效日期。
- toDate(string, format, cal[, baseYear=1900])
- Parameters:
字符串 – str
format –
FormatType
cal –
QCalendar
baseYear – int
- Return type:
这是一个重载函数。
- toDate(string, format, cal[, baseYear=1900])
这是一个重载函数。
- toDateTime(string[, format=QLocale.FormatType.LongFormat[, baseYear=1900]])¶
- Parameters:
字符串 – str
format –
FormatType
baseYear – int
- Return type:
将
string
读取为特定语言环境的format
中的日期时间。解析
string
并返回其表示的日期时间。日期字符串的格式根据format
参数选择(参见dateFormat()
)。一些地区,特别是对于
ShortFormat
,只使用年份的最后两位数字。在这种情况下,从baseYear
开始的100年是首先考虑的候选。在6.7版本之前,没有baseYear
参数,总是使用1900年。这是baseYear
的默认值,从那时到1999年选择一个年份。在某些情况下,其他字段可能会导致选择下一个或上一个世纪,以获得与所有给定字段一致的结果。详情请参见fromString()
。如果字符串无法解析,则返回一个无效的
QDateTime
。- toDateTime(string, format[, baseYear=1900])
- Parameters:
字符串 – str
format – str
baseYear – int
- Return type:
将
string
读取为给定format
格式的日期时间。解析
string
并返回其表示的日期时间。有关format
的解释,请参见fromString()
。当
format
仅指定年份的最后两位数字时,首先考虑的是从baseYear
开始的100年。在6.7版本之前,没有baseYear
参数,总是使用1900年。这是baseYear
的默认值,从那时到1999年之间选择一个年份。在某些情况下,其他字段可能会导致选择下一个或上一个世纪,以获得与所有给定字段一致的结果。详情请参见fromString()
。如果字符串无法解析,则返回一个无效的
QDateTime
。如果字符串可以解析但表示一个无效的日期时间(例如在时区转换跳过的间隔中),则返回一个无效的QDateTime
,其toMSecsSinceEpoch()表示一个附近的有效日期时间。将其传递给fromMSecsSinceEpoch()将生成一个有效的日期时间,但该日期时间无法通过解析的字符串准确表示。- toDateTime(string, format, cal[, baseYear=1900])
- Parameters:
字符串 – str
format –
FormatType
cal –
QCalendar
baseYear – int
- Return type:
这是一个重载函数。
- toDateTime(string, format, cal[, baseYear=1900])
这是一个重载函数。
- toDouble(s)¶
- Parameters:
s – 字符串
- Return type:
(float, bool ok)
警告
本节包含从C++自动翻译到Python的代码片段,可能包含错误。
返回由本地化字符串
s
表示的双精度值。如果转换溢出则返回无穷大,如果由于任何其他原因(例如下溢)导致转换失败,则返回0.0。
如果
ok
不是None
,则通过将 *``ok`` 设置为false
来报告失败,通过将 *``ok`` 设置为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
请注意,最后一次转换返回1234.0,因为在德语区域设置中,'.'是千位分隔符。
此函数忽略前导和尾随的空白字符。
另请参阅
- toFloat(s)¶
- Parameters:
s – 字符串
- Return type:
(float, bool ok)
返回由本地化字符串
s
表示的浮点数。如果转换溢出则返回无穷大,如果由于任何其他原因(例如下溢)导致转换失败则返回0.0。
如果
ok
不是None
,则通过将 *``ok`` 设置为false
来报告失败,通过将 *``ok`` 设置为true
来报告成功。此函数忽略前导和尾随的空白字符。
另请参阅
- toInt(s)¶
- Parameters:
s – 字符串
- Return type:
(int, bool ok)
返回由本地化字符串
s
表示的整数。如果转换失败,函数返回0。
如果
ok
不是None
,则通过将 *``ok`` 设置为false
来报告失败,通过将 *``ok`` 设置为true
来报告成功。此函数忽略前导和尾随的空白字符。
另请参阅
- toLong(s)¶
- Parameters:
s – 字符串
- Return type:
(int, bool ok)
返回由本地化字符串
s
表示的长整型数。如果转换失败,函数返回0。
如果
ok
不是None
,则通过将 *``ok`` 设置为false
来报告失败,通过将 *``ok`` 设置为true
来报告成功。此函数忽略前导和尾随的空白字符。
- toLongLong(s)¶
- Parameters:
s – 字符串
- Return type:
(int, bool ok)
返回由本地化字符串
s
表示的 long long int。如果转换失败,函数返回0。
如果
ok
不是None
,则通过将 *``ok`` 设置为false
来报告失败,通过将 *``ok`` 设置为true
来报告成功。此函数忽略前导和尾随的空白字符。
- toLower(str)¶
- Parameters:
str – 字符串
- Return type:
字符串
返回
str
的小写副本。如果Qt Core正在使用ICU库,它们将根据当前区域设置的规则执行转换。否则,转换可能会以平台相关的方式进行,使用
toLower()
作为通用回退。另请参阅
toLower()
- toShort(s)¶
- Parameters:
s – 字符串
- Return type:
(int, bool ok)
返回由本地化字符串
s
表示的短整型。如果转换失败,函数返回0。
如果
ok
不是None
,则通过将 *``ok`` 设置为false
来报告失败,通过将 *``ok`` 设置为true
来报告成功。此函数忽略前导和尾随的空白字符。
另请参阅
- toString(i)¶
- Parameters:
i – 整数
- Return type:
字符串
这是一个重载函数。
另请参阅
- toString(i)
- Parameters:
i – 整数
- Return type:
字符串
这是一个重载函数。
另请参阅
- toString(i)
- Parameters:
i – 整数
- Return type:
字符串
返回
i
的本地化字符串表示。- toString(date[, format=QLocale.FormatType.LongFormat])
- Parameters:
日期 –
QDate
format –
FormatType
- Return type:
字符串
这是一个重载函数。
- toString(date, format)
- Parameters:
日期 –
QDate
format – str
- Return type:
字符串
返回给定
date
在指定format
中的本地化字符串表示。如果format
为空字符串,则返回空字符串。另请参阅
- toString(time[, format=QLocale.FormatType.LongFormat])
- Parameters:
时间 –
QTime
format –
FormatType
- Return type:
字符串
返回给定
time
在指定format
中的本地化字符串表示(参见timeFormat()
)。- toString(time, format)
- Parameters:
时间 –
QTime
format – str
- Return type:
字符串
返回根据指定的
format
格式化的给定time
的本地化字符串表示。如果format
为空字符串,则返回空字符串。另请参阅
- toString(dateTime[, format=QLocale.FormatType.LongFormat])
- Parameters:
dateTime –
QDateTime
format –
FormatType
- Return type:
字符串
这是一个重载函数。
- toString(dateTime, format)
- Parameters:
dateTime –
QDateTime
format – str
- Return type:
字符串
返回根据指定的
format
格式化的给定dateTime
的本地化字符串表示。如果format
为空字符串,则返回空字符串。- toString(date, format, cal)
- Parameters:
日期 –
QDate
format –
FormatType
cal –
QCalendar
- Return type:
字符串
返回给定
date
的本地化字符串表示,根据指定的format
(参见dateFormat()
),可选地用于指定的日历cal
。注意
某些地区可能使用的格式限制了它们可以表示的年份范围。
- toString(dateTime, format, cal)
- Parameters:
dateTime –
QDateTime
format –
FormatType
cal –
QCalendar
- Return type:
字符串
返回给定
dateTime
的本地化字符串表示,根据指定的format
(参见dateTimeFormat()
),可选地用于指定的日历cal
。注意
某些地区可能使用限制其可表示年份范围的格式。
- toString(f[, format='g'[, precision=6]])
- Parameters:
f – 浮点数
format – int
precision – int
- Return type:
字符串
这是一个重载函数。
返回表示浮点数
f
的字符串。表示形式由
format
和precision
参数控制。format
默认为'g'
。它可以是以下任意一种:格式
含义
precision
的含义'e'
格式为 [-]9.9e[+|-]999
小数点后的位数
'E'
格式为 [-]9.9E[+|-]999
“
'f'
格式化为 [-]9.9
“
'F'
与
'f'
相同,除了 INF 和 NAN(见下文)“
'g'
使用
'e'
或'f'
格式,选择更简洁的一种最大有效数字位数(尾随零被省略)
'G'
使用
'E'
或'F'
格式,选择更简洁的“
特殊的
precision
值FloatingPointShortest
选择最短的表示形式,当作为数字读取时,可以恢复原始的浮点值。除此之外,任何负的precision
都会被忽略,而使用默认值 6。对于
'e'
、'f'
和'g'
格式,正无穷大表示为“inf”,负无穷大表示为“-inf”,浮点数的NaN(非数字)值表示为“nan”。对于'E'
、'F'
和'G'
格式,使用“INF”和“NAN”代替。这不随地区设置而变化。- toString(f[, format='g'[, precision=6]])
- Parameters:
f – 浮点数
format – int
precision – int
- Return type:
字符串
这是一个重载函数。
返回表示浮点数
f
的字符串。format
和precision
的含义与toString(double, char, int)
中描述的含义相同。- toTime(string[, format=QLocale.FormatType.LongFormat])¶
- Parameters:
字符串 – str
format –
FormatType
- Return type:
读取
string
作为特定地区的时间format
。解析
string
并返回其表示的时间。时间字符串的格式根据format
参数选择(参见timeFormat()
)。如果时间无法解析,则返回无效时间。
- toTime(string, format)
- Parameters:
字符串 – str
format – str
- Return type:
将
string
读取为给定format
中的时间。解析
string
并返回其表示的时间。有关format
的解释,请参见fromString()
。如果时间无法解析,则返回一个无效的时间。
- toUInt(s)¶
- Parameters:
s – 字符串
- Return type:
(int, bool ok)
返回由本地化字符串
s
表示的无符号整数。如果转换失败,函数返回0。
如果
ok
不是None
,则通过将 *``ok`` 设置为false
来报告失败,通过将 *``ok`` 设置为true
来报告成功。此函数忽略前导和尾随的空白字符。
另请参阅
- toULong(s[, ok=None])¶
- Parameters:
s – 字符串
ok – 布尔值
- Return type:
整数
返回由本地化字符串
s
表示的无符号长整型。如果转换失败,函数返回0。
如果
ok
不是None
,则通过将 *``ok`` 设置为false
来报告失败,通过将 *``ok`` 设置为true
来报告成功。此函数忽略前导和尾随的空白字符。
- toULongLong(s)¶
- Parameters:
s – 字符串
- Return type:
(int, bool ok)
返回由本地化字符串
s
表示的无符号长整型。如果转换失败,函数返回0。
如果
ok
不是None
,则通过将 *``ok`` 设置为false
来报告失败,通过将 *``ok`` 设置为true
来报告成功。此函数忽略前导和尾随的空白字符。
- toUShort(s)¶
- Parameters:
s – 字符串
- Return type:
(int, bool ok)
返回由本地化字符串
s
表示的无符号短整型。如果转换失败,函数返回0。
如果
ok
不是None
,则通过将 *``ok`` 设置为false
来报告失败,通过将 *``ok`` 设置为true
来报告成功。此函数忽略前导和尾随的空白字符。
另请参阅
- toUpper(str)¶
- Parameters:
str – 字符串
- Return type:
字符串
返回
str
的大写副本。如果Qt Core正在使用ICU库,它们将根据当前区域设置的规则执行转换。否则,转换可能会以平台相关的方式进行,
toUpper()
作为通用回退。注意
在某些情况下,字符串的大写形式可能比原始形式更长。
另请参阅
toUpper()
- uiLanguages([separator=QLocale.TagSeparator.Dash])¶
- Parameters:
分隔符 –
TagSeparator
- Return type:
字符串列表
用于选择翻译的区域设置名称列表
返回列表中的每个条目都是适合用户偏好的区域设置名称,用于将用户界面翻译成何种语言。如果列表中的名称由多个标签组成,它们将按照
separator
指示的方式连接。在Qt 6.7之前,使用破折号作为分隔符。例如,使用默认分隔符
Dash
,如果用户将系统配置为使用美国英语,列表将是“en-Latn-US”,“en-US”,“en”。条目的顺序是检查翻译的顺序;列表中的较早项应优先于较晚项。如果您的翻译文件使用下划线而不是破折号来分隔区域设置标签,请将Underscore
作为separator
传递。返回的列表可能包含多种语言的条目。特别是,当用户配置系统以接受多种语言进行用户界面翻译时,
system locale
会发生这种情况。在这种情况下,不同语言条目的顺序是重要的。例如,如果用户配置了一个主要使用德语的系统,同时也接受英语和中文,按照这种偏好顺序,返回的列表将包含一些德语条目,然后是一些英语条目,最后是一些中文条目。很可能你不需要直接使用这个函数,只需将
QLocale
对象传递给load()
函数即可。另请参阅
- weekdays()¶
- Return type:
Qt.DayOfWeek的列表
返回根据当前区域设置被视为工作日的日期列表。
- zeroDigit()¶
- Return type:
字符串
返回此语言环境的零数字字符。
这是一个单一的Unicode字符,但可能被编码为代理对,因此(自Qt 6.0起)作为字符串返回。在大多数语言环境中,其他数字在Unicode顺序中紧随其后 - 然而,一些数字系统,特别是那些使用U+3007作为零的系统,没有连续的数字。使用
toString()
来获取数字的合适表示,而不是尝试从这个零数字构造它们。另请参阅