class QLocale#

类QLocale在多种语言之间转换数字及其字符串表示形式。 更多...

概述#

方法#

静态函数#

注意

本文档可能包含自动从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 的数据基于 Common Locale Data Repository v44.1。

语言、脚本和区域的匹配组合#

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

已废弃，请使用奥罗莫

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.Armian

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

废弃，请使用孟加拉语

QLocale.Bhojpuri

QLocale.Bhutan

已经废弃，请使用不丹语

QLocale.Bislama

QLocale.Blin

QLocale.Bodo

QLocale.Bosnian

QLocale.Breton

QLocale.Buginese

QLocale.Bulgarian

QLocale.Burma

QLocale.Byelorussian

废弃，请使用白俄罗斯语

QLocaleCambodian

废弃，请使用柬埔寨语

QLocale.Cantonese

QLocale.Catalan

QLocale.Cebuano

QLocale.CentralAtlasTamazight

QLocale.CentralKurdish

QLocale.CentralMoroccoTamazight

废弃，请使用CentralAtlasTamazight

QLocale.Chakma

QLocale.Chamorro

QLocale.Cherokee

QLocale.Cheerokee

QLocale.Chewa

废弃，请使用尼亚萨

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

与西方弗里斯兰相同

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.Kannada

QLocale.Kanuri

QLocale.Kashmiri

QLocale.Kazakh

QLocale.Kenyang

QLocale.Khmer

QLocale.Kiche

QLocale.Kikuyu

QLocale.Kinyarwanda

QLocale.Kirghiz

已废弃，请使用Kyrgyz

QLocale.Komi

QLocale.Kongo

QLocale.Konkani

QLocale.Korean

QLocale.Koro

QLocale.KoyraboroSenni

QLocale.KoyraChiini

QLocale.Kpelle

QLocale.Kuanyama

QLocale.Kurdish

QLocale.Kurundi

已废弃，请使用Rundi

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

已废弃，请使用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.Pashto

QLocale.Persian

QLocale.Phoenician

QLocale.Pijin

QLocale.Polish

QLocale.Portuguese

QLocale.Prussian

QLocale.Punjabi

QLocale.Quechua

QLocale.Rajasthani

QLocale.RhaetoRomance

已废弃，请使用 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

已废弃，请使用 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.WesternBalochi

QLocale.WesternFrisian

与荷兰语相同

QLocale.Wolaytta

QLocale.Wolof

QLocale.Xhosa

QLocale.Yangben

QLocale.Yiddish

QLocale.Yoruba

QLocale.Zarma

QLocale.Zhuang

QLocale.Zulu

参见

language() languageToString()

class Script#

此枚举类型用于指定脚本。

常量

描述

QLocale.AnyScript

QLocale.AdlamScript

QLocale.AhomScript

QLocale.AnatolianHieroglyphsScript

QLocale.ArabicScript

QLocale.ArmianScript

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

已废弃，请使用 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.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

与 TraditionalHanScript 相同

QLocale.TraditionalHanScript

与 TraditionalChineseScript 相同

QLocale.UgariticScript

QLocale.VaiScript

QLocale.VarangKshitiScript

QLocale.YiScript

参见

script() scriptToString() languageToString()

从版本 4.8 开始。

class Country#

此枚举类型用于识别领土。

一个领土可能是一个国家的省份，一个国家（最常见的情况）或更大的地理实体，其中某些本地化细节是特定的。

常量

描述

QLocale.AnyCountry

已废弃的别名 for AnyTerritory

QLocale.AnyTerritory

QLocale.Afghanistan

QLocale.AlandIslands

QLocale.Albania

QLocale.Algeria

QLocale美属萨摩亚

QLocale安道尔

QLocale安哥拉

QLocale安圭拉

QLocale南极

QLocale安提瓜和巴布达

QLocale阿根廷

QLocale亚美尼亚

QLocale阿鲁巴

QLocaleAscension岛

QLocale澳大利亚

QLocale奥地利

QLocale阿塞拜疆

QLocale巴哈马

QLocale巴林

QLocale孟加拉国

QLocale巴巴多斯

QLocale白俄罗斯

QLocale比利时

QLocale伯利兹

QLocale贝宁

QLocale百慕大

QLocale不丹

QLocale玻利维亚

QLocale博奈尔岛

QLocale波斯尼亚和黑塞哥维那

已废弃，请使用 BosniaAndHerzegovina 代替

QLocale波斯尼亚和黑塞哥维那

QLocale博茨瓦纳

QLocale布维岛

QLocale巴西

QLocale英属印度洋领地

QLocale英属维尔京群岛

QLocale文莱

QLocale保加利亚

QLocale布基纳法索

QLocale布隆迪

QLocale柬埔寨

QLocale喀麦隆

QLocale加拿大

QLocale加那利群岛

QLocale荷兰加勒比地区

QLocale佛得角

QLocale开曼群岛

QLocale中非共和国

QLocale休达和梅利利亚

QLocale乍得

QLocale智利

QLocale中国

QLocale圣诞岛

QLocale克利珀顿岛

QLocale库克群岛

QLocale哥斯达黎加

QLocale克罗地亚

QLocale古巴

QLocale库拉索岛

QLocale库拉索

QLocale克里特岛

QLocale塞舌尔

QLocale塞舌尔

QLocale科摩罗

QLocale刚果布razzaville

QLocale刚果金萨萨

QLocale库克群岛

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale哥斯达黎加

QLocale.摩洛哥

QLocale.莫桑比克

QLocale.缅甸

QLocale.纳米比亚

QLocale.瑙鲁国家

Osbolete 异名于 NauruTerritory

QLocale.瑙鲁领地

QLocale.尼泊尔

QLocale.荷兰

QLocale.新喀里多尼亚

QLocale.新西兰

QLocale.尼加拉瓜

QLocale.尼日尔

QLocale.尼日利亚

QLocale.纽埃

QLocale.诺福克岛

QLocale.北马里亚纳群岛

QLocale.朝鲜

QLocale.挪威

QLocale.阿曼

QLocale.远东大洋洲

QLocale.巴基斯坦

QLocale.帕劳

QLocale.巴勒斯坦领土

QLocale.巴拿马

QLocale.巴布亚新几内亚

QLocale.巴拉圭

QLocale.刚果人民共和国

已废弃，请使用《CongoBrazzaville》代替

QLocale.秘鲁

QLocale.菲律宾

QLocale.皮特凯恩群岛

QLocale.波兰

QLocale.葡萄牙

QLocale.波多黎各

QLocale.卡塔尔

QLocale.大韩民国

已废弃，请使用《SouthKorea》代替

QLocale.留尼汪岛

QLocale.罗马尼亚

QLocale.俄罗斯联邦

QLocale.俄罗斯

QLocale.卢旺达

QLocale.圣巴泰勒米岛

QLocale.圣赫尔拿岛

QLocale.圣基茨和尼维斯

QLocale.圣卢西亚岛

QLocale.圣马丁岛

QLocale.圣皮埃尔和密克隆群岛

QLocale.圣文森特和格林纳丁斯

QLocale.圣文森特和格林纳丁斯

QLocale.萨摩亚

QLocale.圣马力诺共和国

QLocale.圣多美和普林西比

QLocale.沙特阿拉伯

QLocale.塞内加尔

QLocale.塞尔维亚

QLocale.塞舌尔

QLocale.塞拉利昂

QLocale.新加坡

QLocale.圣马丁

QLocale.斯洛伐克

QLocale.斯洛文尼亚

QLocale.所罗门群岛

QLocale.索马里

QLocale.南非

QLocale.南乔治亚岛和南桑威奇群岛

QLocale.南乔治亚岛和南桑威奇群岛

QLocale.韩国

QLocale.南苏丹

QLocale.西班牙

QLocale.斯里兰卡

QLocale.苏丹

QLocale.苏里南

QLocale.斯瓦尔巴群岛和扬马延岛

QLocale.斯瓦尔巴群岛和扬马延岛

QLocale.斯威士兰

QLocale.瑞典

QLocale.瑞士

QLocale.叙利亚

QLocale.阿拉伯叙利亚共和国

已废弃，请使用《Syria》代替

QLocale.台湾

QLocale.塔吉克斯坦

QLocale.坦桑尼亚

QLocale.泰国

QLocale.东帝汶

QLocale.多哥

QLocale.托克劳国家

Osbolete 异名于 TokelauTerritory

QLocale.托克劳领地

QLocale.汤加

QLocale.特立尼达和多巴哥

QLocale.特里斯坦达库尼亚岛

QLocale.突尼斯

QLocale.土耳其

QLocale.土库曼斯坦

QLocale.特克斯和凯科斯群岛

QLocale.图瓦卢国家

Osbolete 异名于 TuvaluTerritory

QLocale.图瓦卢领地

QLocale.乌干达

QLocale.乌克兰

QLocale.阿拉伯联合酋长国

QLocale.英国

QLocale.美国

QLocale.美国海外领地

QLocale.美国小海外领地

QLocale.美属维尔京群岛

QLocale.乌拉圭

QLocale.乌兹别克斯坦

QLocale.瓦努阿图

QLocale.梵蒂冈城

QLocale.梵蒂冈城国

QLocale.委内瑞拉

QLocale.越南

QLocale.瓦利斯和富图纳群岛

QLocale.瓦利斯和富图纳群岛

QLocale.西撒哈拉

QLocale.世界

QLocale.也门

QLocale.赞比亚

QLocale.津巴布韦

注意

尽可能使用领地别名。Country 枚举将在以后的版本中重命名为 Territory。

参见

territory() territoryToString() codeToTerritory() territoryToCode()

class MeasurementSystem#

该枚举用于定义用于测量的单位。

常量

描述

QLocale.MetricSystem

此值表示公制单位，例如米、厘米和毫米。

QLocale.ImperialUSSystem

此值表示美国使用的英制单位，例如英寸和英里。

QLocale.ImperialUKSystem

此值表示英国使用的英制单位，例如英寸和英里。

QLocale.ImperialSystem

以兼容性提供。与ImperialUSSystem相同。
class FormatType#

该枚举描述了在将QDate、QTime、QDateTime对象以及月份和天数转换为特定于区域设置的字符串时，可以使用的不同格式。

常量

描述

QLocale.LongFormat

更长的格式。

QLocale.ShortFormat

较短的格式。

QLocale.NarrowFormat

一种用于空间非常有限时的特殊版本。

注意

NarrowFormat可能包含不同月份和天数相同的文本。如果区域设置不支持窄名称，它甚至可以是空字符串，因此应避免用于日期格式化。此外，对于系统区域设置，此格式与ShortFormat相同。

参见

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

class NumberOption#

(继承 enum.Flag)) 此枚举定义了一组数字到字符串和字符串到数字转换的选项。可以使用 numberOptions() 获取它们，并通过 setNumberOptions() 设置它们。

常量

描述

QLocale.DefaultNumberOptions

此选项表示默认行为，带有分组分隔符，单个数字指数带有一个前导零，小数点后没有尾随零。

QLocale.OmitGroupSeparator

如果设置此选项，数字到字符串的函数不会在其返回值中插入分组分隔符。默认情况下会插入分组分隔符。

QLocale.RejectGroupSeparator

如果设置此选项，字符串到数字的函数在输入中遇到分组分隔符时会失败。默认情况下会接受带有正确放置的分组分隔符的数字。

QLocale.OmitLeadingZeroInExponent

如果设置此选项，数字到字符串的函数在以科学记数法打印浮点数时，不会用零填充指数。默认情况下会在单个数字的指数中添加一个前导零。

QLocale.RejectLeadingZeroInExponent

如果设置此选项，字符串到数字的函数在解析以科学记数法表示的浮点数时，遇到用零填充的指数会失败。默认情况下会接受此类填充。

QLocale.IncludeTrailingZeroesAfterDot

如果设置此选项，数字到字符串的函数在“g”或“最简洁”模式下会用零填充数字以达到所需的精度，即使有效数字的数量低于请求的精度。默认情况下会省略尾随零。

QLocale.RejectTrailingZeroesAfterDot

如果设置此选项，字符串到数字的函数在解析科学记数法或十进制表示法表示的数字时，遇到小数点后的尾随零会失败。默认情况下会接受尾随零。

参见

setNumberOptions() numberOptions() FloatingPointPrecisionOption

class FloatingPointPrecisionOption#

(继承 enum.IntEnum)) 此枚举定义了一个可以给 number()，number()，以及toString() 传递的常量，这些函数在将浮点数或双精度浮点数转换为字符串时使用，以便将可变位数表示为精度。

常量

描述

QLocale.FloatingPointShortest

转换算法将尝试找到给定数值的最短准确表示。“准确”意味着您可以从生成的字符串表示形式的逆转换中获取完全相同的数值。特别是，省略了尾随零（在指数格式中从尾数中省略）。

参见

toString() number() number()

class TagSeparator#

指示如何组合组成locale标识符的各个部分。

locale标识符可能由几个标签组成，表示语言、脚本和地区（可能还包括其他详细信息），并组合在一起形成标识符。各种标准和传统形式使用破折号（Unicode破折号，U+002D）或下划线（下划线，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、……

参见

formattedDataSize()

class LanguageCodeType#

(继承自 enum IntFlag) 此枚举定义了可以用于限制codeToLanguage和languageToCode考虑的代码类型的语言代码类型。

常量

描述

QLocale.ISO639Part1

ISO 639 Part 1 Alpha 2代码。

QLocale.ISO639Part2B

ISO 639 Part 2 bibliographic Alpha 3代码。

QLocale.ISO639Part2T

ISO 639 Part 2 terminological Alpha 3代码。

QLocale.ISO639Part3

ISO 639 Part 3 Alpha 3代码。

QLocale.LegacyLanguageCode

不属于上述集合但过去由 Qt 支持的代码。此值只能由 codeToLanguage() 使用。将其传递给 languageToCode() 时将忽略。

QLocale.ISO639Part2

任何 ISO 639 Part 2 代码。

QLocale.ISO639Alpha2

任何 ISO-639 两字母代码。

QLocale.ISO639Alpha3

任何 ISO-639 三字母代码。

QLocale.ISO639

任何 ISO 639 代码。

QLocale.AnyLanguageCode

指定可以使用任何代码。

自 6.3 版本开始。

class QuotationStyle#

此枚举定义了区域特定引号的可能样式集。

常量

描述

QLocale.StandardQuotation

如果设置了此选项，则将使用标准引号括住字符串。

QLocale.AlternateQuotation

如果设置了此选项，则将使用备选引号括住字符串。

参见

quoteString()

从版本 4.8 开始。

PySide6.QtCore.QLocale.DefaultTwoDigitBaseYear#
__init__(language, territory)#
参数：:

构建一个针对指定 language 和 territory 的 QLocale 对象。

如果此组合使用了多个脚本，则将选择一个可能的脚本。如果 QLocale 没有针对指定 language 的数据，则使用默认区域。如果 QLocale 没有针对指定 language 和 territory 的组合的数据，则可以使用备选区域。

参见

setDefault() 匹配的 language、script 和 territory 组合

__init__()

使用默认区域构建一个 QLocale 对象。

如果没有使用 setDefault() 设置默认区域设置，则此区域设置将与 system() 返回的区域设置相同。

__init__(name)
参数：:

name – str

这是一个重载函数。

__init__(other)
参数：:

other – QLocale

根据 other 创建一个 QLocale 对象的副本。

__init__(language[, script=QLocale.Script.AnyScript[, territory=QLocale.Country.AnyTerritory]])
参数：:

为指定的 language、script 和 territory 创建一个 QLocale 对象。

如果 QLocale 对于给定的组合没有数据，它将找到尽可能好的匹配数据。如果 language 是 AnyLanguage 且无法从 script 和 territory 推断出语言，则回退到默认区域设置。

  • language 是 AnyLanguage 且无法从 script 和 territory 推断出语言。

  • QLocale 对于给定的语言没有数据，无论是作为 language 给出，还是像上面那样推断出来。

参见

setDefault() 匹配的 language、script 和 territory 组合

__init__(name)
参数：:

name – str

使用指定的 name 创建一个 QLocale 对象。

名称的格式为“language[_script][_territory][.codeset][@modifier]”或“C”，其中

  • language 是小写、两位字母的 ISO 639 语言代码（一些三位字母代码也被认可），

  • script 是大写、四位字母的 ISO 15924 字符脚本代码，

  • territory 是大写、两位字母的 ISO 3166 领土代码（一些数字代码也被认可），

  • codeset 和 modifier 被忽略。

分隔符可以是下划线'_'（U+005F，“低线”）或破折号'-'（U+002D，“连字符减号”）。如果QLocale对于指定的语言、脚本和国家/地区组合没有数据，则使用最合适的匹配项。如果字符串违反了区域格式，或找不到指定键的适当数据，将使用“C”区域设置。

此构造函数比QLocale（语言、脚本、国家/地区）或QLocale（语言、国家/地区）慢得多。

参见

bcp47Name()

amText()#
返回类型

str

返回使用12小时制约定指定的时间的“AM”后缀的本地化名称。

参见

pmText()

bcp47Name([separator=QLocale.TagSeparator.Dash])#
参数：:

separator – TagSeparator

返回类型

str

以破折号连接BCP47字段名称。

此函数将尽可能组合语言、脚本和国家/地区（以及可能的BCP47字段），以唯一指定此区域。注意，如果Unicode联盟的“可能子标签规则”暗示已保留字段时省略字段，则可以省略字段。有关如何从单个字段构造字符串的详细信息，请参见name()，如果需要其他格式。

与uiLanguages()不同，bcp47Name()返回的值代表QLocale数据区域名称；这不一定是用户界面应该使用该语言。

此函数尝试使区域名称符合IETF最佳实践47，由RFC 5646定义。自Qt 6.7以来，它支持一个可选的separator参数，可以用来覆盖BCP47指定的连字符用于分隔标签的使用。但是，对于IETF定义的协议，应保留默认的Dash（破折号）。

static c()#
返回类型

QLocale

返回一个初始化为“C”区域设置的 QLocale 对象。

这个区域设置基于 en_US，但也有自己的各种特性，如简化的数字格式和自己的日期格式。它实现了描述“C”编程语言标准库函数行为的 POSIX 标准。

这意味着它的排序顺序基于字母的 ASCII 值，因此（对于区分大小写的排序）所有大写字母都排在所有小写字母之前（而不是每个字母的大写和小写形式相邻排序，然后再是下一个字母的两个形式）。

参见

system()

static codeToCountry(countryCode)#
参数：:

countryCode – str

返回类型

国家

注意

此函数已过时。

返回与 ISO 3166 标准中定义的两位或三位 countryCode 对应的 QLocale::Territory 枚举。

如果代码无效或不为人所知，则返回 AnyTerritory。

使用 codeToTerritory ( QStringView ) 代替。

static codeToLanguage(languageCode[, codeTypes=QLocale(LanguageCodeType.AnyLanguageCode)])#
参数：:
返回类型

语言

返回与ISO 639标准定义的两个或三个字母的languageCode对应的Language枚举。

如果指定，codeTypes将选择用于转换的代码集合。默认情况下，所有Qt已知的代码都将被考虑。代码的匹配顺序如下：ISO639Part1、ISO639Part2B、ISO639Part2T、ISO639Part3、LegacyLanguageCode。

如果代码无效或未知，则返回QLocale::AnyLanguage。

静态 codeToScript(scriptCode)#
参数：:

scriptCode – str

返回类型

脚本

返回与ISO 15924标准定义的四个字母脚本码Script对应的枚举。

如果代码无效或未知，则返回AnyScript。

静态 codeToTerritory(territoryCode)#
参数：:

territoryCode – str

返回类型

国家

返回与ISO 3166标准定义的两个字母或三位数字的territoryCode对应的QLocale::Territory枚举。

如果代码无效或不为人所知，则返回 AnyTerritory。

collation(a)
返回类型

QLocale

返回用于排序的locale。

结果通常是此locale；然而，系统locale（通常是默认locale）将返回系统排序locale。结果适用于传递给QCollator 构造函数。

参见

QCollator

static countriesForLanguage(lang)#
参数：:

lang – Language

返回类型

QLocale.Country 列表

注意

此函数已过时。

使用 matchingLocales() 替代，并参考每个的 territory()。

返回 Qt 的区域设置数据库中具有 language 条目的国家列表。如果结果为空列表，则表示 language 在 Qt 的区域设置数据库中未表示。

country()#
返回类型

国家

注意

此函数已过时。

使用 territory() 替代。

返回此区域设置的领土。

static countryToCode(country)#
参数：:

country – Country

返回类型

str

注意

此函数已过时。

使用 territoryToCode() 替代。

返回 country 的两个字母领土代码，根据 ISO 3166 标准。

注意

对于 QLocale::AnyTerritory 或 QLocale::AnyCountry 返回空字符串。

参见

codeToTerritory() territory() name() bcp47Name() languageToCode() scriptToCode()

static countryToString(country)#
参数：:

country – Country

返回类型

str

注意

此函数已过时。

建议使用 territoryToString() 替代。

返回一个包含 QString 的名称的字符串。

createSeparatedList(strl)链接到此处定义
参数：:

strl - 字符串列表

返回类型

str

返回一个字符串，表示由地区定义的分隔符连接给定的 list 中的字符串。

currencySymbol([arg__1=QLocale.CurrencySymbolFormat.CurrencySymbol])#
参数：:

arg__1 - CurrencySymbolFormat

返回类型

str

根据 format 返回货币符号。

dateFormat([format=QLocale.FormatType.LongFormat])#
参数：:

format - FormatType

返回类型

str

返回当前地区使用的日期格式。

如果 format 是 LongFormat ，则格式将会详细，否则将是简短。例如，针对 en_US 本地化，LongFormat 格式为 dddd, MMMM d, yyyy，ShortFormat 格式为 M/d/yy。

dateTimeFormat([format=QLocale.FormatType.LongFormat])#
参数：:

format - FormatType

返回类型

str

返回当前本地化使用的日期时间格式。

如果 format 是 LongFormat ，则格式将会详细，否则将是简短。例如，针对 en_US 本地化，LongFormat 格式为 dddd, MMMM d, yyyy h:mm:ss AP t，ShortFormat 格式为 M/d/yy h:mm AP。

dayName(arg__1[, format=QLocale.FormatType.LongFormat])#
参数：:
返回类型

str

以指定的格式返回 day 的本地化名称（其中 1 表示星期一，2 表示星期二，依此类推）。

例如，如果区域设置是 en_US 且 day 的值为 1，LongFormat 将返回 Monday，ShortFormat Mon，以及 NarrowFormat M。

decimalPoint()#
返回类型

str

返回此区域设置的分数部分分隔符。

这是在表示有分数部分的数字时，用于将整数部分与分数部分分开的标记。这通常被称为“小数点字符”——即使在许多区域设置中，它不是“点”（或类似的圆点）。从 Qt 6.0 开始，它被作为一个字符串返回，以防某些区域设置需要多个 UTF-16 代码点来表示其分隔符。

exponential()#
返回类型

str

返回此区域设置的指数分隔符。

这是一种用于在有些浮点数表示法中将尾数与指数分开的标记。从 Qt 6.0 开始，它被作为一个字符串返回，因为，在某些区域设置中，它不是一个单一的字符——例如，它可能由一个乘号和一个表示“10的n次方”操作符的部分组成。

参见

toString(double, char, int)

firstDayOfWeek()#
返回类型

DayOfWeek

返回根据当前区域设置的第一个星期天。

formattedDataSize(bytes[, precision=2[, format=QLocale.DataSizeFormat.DataSizeIecFormat]])#
参数：:
返回类型

str

将字节数转换成一个本地化的、可读的字符串，包含数字和量化的单位。量化器的选择使得数字至少为1，尽可能小。例如，如果 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()#
返回类型

str

返回此地区的数字分组分隔符。

这是用于分割长数字序列的标记，用来在数字的表示中将数字分组，使其更易于阅读。在某些地区，它可能为空，表示不应按这种方式将数字分组。在其他地区，它可能是一个空格字符。自 Qt 6.0 以来，它作为字符串返回，以便在某些地区可能需要多个UTF-16代码点来表示其分隔符。

language()#
返回类型

语言

返回此地区使用的语言。

static languageToCode(language[, codeTypes=QLocale.LanguageCodeType.AnyLanguageCode])#
参数：:
返回类型

str

返回语言 language 的双字母或三字母语言代码，该代码由 ISO 639 标准定义。

如果指定，则 codeTypes 选择要考虑的代码集。返回为 language 定义的集合中的第一个代码。否则，考虑所有 ISO-639 代码。代码按以下顺序考虑：ISO639Part1、ISO639Part2B、ISO639Part2T、ISO639Part3。此函数忽略 LegacyLanguageCode。

注意

对于 QLocale::C，该函数返回 "C"。对于 QLocale::AnyLanguage 返回空字符串。如果语言在任何选定的代码集中都没有代码，则返回空字符串。

参见

codeToLanguage() language() name() bcp47Name() territoryToCode() scriptToCode()

static languageToString(language)#
参数：:

language – Language

返回类型

str

返回包含 language 名称的 QString 对象。

static matchingLocales(language, script, territory)#
参数：:
返回类型

. QLocale 列表

返回与给定的 language、script 和 territory 匹配的有效地区对象列表。

获取所有区域列表：QList< QLocale > allLocales = QLocale::matchingLocales( AnyLanguage , AnyScript , AnyTerritory );

获取适合俄罗斯的区域列表：QList< QLocale > locales = QLocale::matchingLocales( AnyLanguage , AnyScript , Russia );

measurementSystem()#
返回类型

测量系统

返回区域的测量系统。

monthName(arg__1[, format=QLocale.FormatType.LongFormat])#
参数：:
返回类型

str

以指定的格式返回 month 的本地化名称。

例如，如果区域为 en_US 且 month 为 1，LongFormat 将返回 一月。 ShortFormat Jan，以及 NarrowFormat J。

name([separator=QLocale.TagSeparator.Underscore])#
参数：:

separator – TagSeparator

返回类型

str

本区域的简短名称。

以 "language_territory" 格式的字符串返回本区域的语言和领土。其中语言为小写，两位 ISO 639 语言代码，领土为大写，两位或三位 ISO 3166 领土代码。如果区域没有指定的领土，则只返回语言名称。自 Qt 6.7 开始，可以通过可选的 separator 参数提供以覆盖默认的下划线分隔符。

即使使用显式脚本创建了 QLocale 对象，出于兼容性原因，name() 方法不会包含该脚本。如果需要完整的区域名称，请使用 bcp47Name()。您也可以通过传递其 language() 方法返回的值到 languageToCode() 以及类似的方法来为脚本和领地构造字符串，以识别区域。

nativeCountryName()#
返回类型

str

注意

此函数已过时。

请使用 nativeTerritoryName() 替代。

返回与区域相关的领地的本地名称。例如，对于西班牙/西班牙语区域，例子为“España”。

nativeLanguageName()#
返回类型

str

返回与区域相关的语言的本地名称。例如，对于瑞士德语区域，例子为“Schweizer Hochdeutsch”。

nativeTerritoryName()#
返回类型

str

返回与区域相关的领地的本地名称。例如，对于西班牙/西班牙语区域，例子为“España”。

negativeSign()#
返回类型

str

返回该区域负号指示符。

这是一个假定用作数字前缀的令牌，用以表示该数字为负。由于某些区域中它可能不是单个字符（例如，因为它包括一个文本方向控制字符），因此自 Qt 6.0 起作为字符串返回。

numberOptions()#
返回类型

NumberOption的组合

返回与该 QLocale 实例数字转换相关的选项。

默认情况下，除了“C”区域设置默认设置了OmitGroupSeparator外，标准区域设置没有设置任何选项。

__ne__(rhs)#
参数：:

rhs – QLocale

返回类型

bool

如果两个 QLocale 对象（lhs 和 rhs）不同，则返回true；否则返回false。

注意

系统区域设置与其从其 language()、script() 和 territory() 构建的区域设置对象不相等，即使两个在所有数据字段上意见一致。不同的数字选项的区域设置也不相等。

参见

setNumberOptions()

__eq__(rhs)#
参数：:

rhs – QLocale

返回类型

bool

如果两个QLocale对象lhs和rhs相同，则返回true，否则返回false。

注意

系统区域设置与其从其 language()、script() 和 territory() 构建的区域设置对象不相等，即使两个在所有数据字段上意见一致。不同的数字选项的区域设置也不相等。

参见

operator!=() setNumberOptions()

percent()#
返回类型

str

返回此区域设置的百分号符号。

这是一个被假定附加到数字上的标记，用来表示一个百分比。自Qt 6.0开始，它以字符串形式返回，因为在某些区域设置中，它可能不是单个字符 - 例如，因为它可能包含一个文本方向控制字符。

参见

toString()

pmText()#
返回类型

str

返回使用12小时制约定指定时间的“PM”后缀的本地化名称。

参见

amText()

positiveSign()#
返回类型

str

返回此区域设置的正面符号指示器。

这是一个假定用作数字前缀的标记，用来表示它是一个正数。自Qt 6.0开始，它以字符串形式返回，因为在某些区域设置中，它可能不是单个字符 - 例如，因为它可能包含一个文本方向控制字符。

quoteString(str[, style=QLocale.QuotationStyle.StandardQuotation])#
参数：:
返回类型

str

这是一个重载函数。

quoteString(str[, style=QLocale.QuotationStyle.StandardQuotation])
参数：:
返回类型

str

返回按照给定的引用style根据当前区域设置引用的str。

script()#
返回类型

脚本

返回此区域设置的语言脚本。

static scriptToCode(script)#
参数：:

script – Script

返回类型

str

返回定义在ISO 15924标准中的script的四字母脚本代码。

注意

对于QLocale::AnyScript会返回空字符串。

参见

script() name() bcp47Name() languageToCode() territoryToCode()

static scriptToString(script)#
参数：:

script – Script

返回类型

str

返回包含script名称的QString。

static setDefault(locale)#
参数：:

locale – QLocale

将全局默认区域设置设置为locale。当使用无参数构造函数创建QLocale对象时，这些值被使用。如果没有调用此函数，将使用系统的区域设置。

警告

在多线程应用程序中，默认的区域设置应该是在创建任何非GUI线程之前，在应用程序启动时设置。

参见

system() c()

setNumberOptions(options)#
参数：:

options – 结合 NumberOption

为此 QLocale 实例设置与数字转换相关的 options。

standaloneDayName(arg__1[, format=QLocale.FormatType.LongFormat])#
参数：:
返回类型

str

返回用于作为独立文本的 day（其中1代表星期一，2代表星期二，依此类推）的本地化名称，格式由 type 指定。

如果区域信息未指定独立日名称，则返回值与 dayName() 中的相同。

standaloneMonthName(arg__1[, format=QLocale.FormatType.LongFormat])#
参数：:
返回类型

str

返回用于作为独立文本的 month 的本地化名称，格式由 type 指定。

如果区域信息未指定独立月份名称，则返回值与 monthName() 中的相同。

swap(other)#
参数：:

other – QLocale

交换 other 与此区域。此操作非常快且从不失败。

static system()#
返回类型

QLocale

返回一个初始化为系统区域的 QLocale 对象。

系统区域可能使用系统特定的区域数据源，如果可用，否则退回到系统报告的语言、脚本和地区 QLocale 内置数据库条目。

例如，在 Windows 上，此区域将使用系统配置面板中指定的十进制/分组字符和日期/时间格式。

注意

在macOS上使用的Python版的Qt不会反映用户的地区和语言首选项，而是反映POSIX使用的环境变量来指定地区，类似于Python的locale模块。如果无法确定系统地区，这可能是因为您的环境中没有设置'LC_ALL'、'LC_CTYPE'、'LANG'或'LANGUAGE'等任何变量，那么将返回默认的POSIX地区或'C'地区。

另请参阅c().

territory()#
返回类型

国家

返回此区域设置的领土。

静态territoryToCode(territory)#
参数：:

territory – Country

返回类型

str

返回territory对应的两个字母的地区代码，该代码根据ISO 3166标准定义。

注意

对于QLocale::AnyTerritory，将返回一个空字符串。

参见

codeToTerritory() territory() name() bcp47Name() languageToCode() scriptToCode()

静态territoryToString(territory)#
参数：:

territory – Country

返回类型

str

返回一个包含territory名称的QString。

textDirection()#
返回类型

LayoutDirection

返回语言的文本方向。

timeFormat([format=QLocale.FormatType.LongFormat])#
参数：:

format - FormatType

返回类型

str

返回当前地区使用的日期格式。

如果format是LongFormat，格式将较为详细，否则将较为简短。例如，对于en_US地区，LongFormat的格式是h:mm:ss AP t，而ShortFormat是h:mm AP。

toCurrencyString(arg__1[, symbol=""[, precision=-1]])#
参数：:

  • arg__1 – float

  • symbol – str

  • precision – int

返回类型

str

这个函数重载了toCurrencyString()。

返回 value 的本地化货币字符串表示。如果提供了 symbol，则使用该符号而不是默认的货币符号。如果提供了 precision，则将其用作设置货币价值的精度。

toCurrencyString(i[, symbol=""[, precision=-1]])
参数：:

  • i – float

  • symbol – str

  • precision – int

返回类型

str

这个函数重载了toCurrencyString()。

toCurrencyString(i[, symbol=""])
参数：:

  • i – int

  • symbol – str

返回类型

str

这是一个重载函数。

toCurrencyString(arg__1[, symbol=""])
参数：:

  • arg__1 - int

  • symbol – str

返回类型

str

返回 value 的本地化货币字符串表示。如果提供了 symbol，则使用该符号而不是默认的货币符号。

toDate(string[, format=QLocale.FormatType.LongFormat[, baseYear=1900]])#
参数：:

  • string – str

  • format - FormatType

  • baseYear – int

返回类型

QDate

按特定地区的格式解析 string 作为日期。

解析 string 并返回表示该日期的日期。日期字符串的格式根据 format 参数选择（参见 dateFormat() )。

有些地区，特别是在 ShortFormat 的情况下，仅在年份的最后两位。在这种情况下，从 baseYear 开始的100年是首先考虑的候选人。在版本6.7之前，没有 baseYear 参数，并且始终使用1900。这是 baseYear 的默认值，选择从那时到1999年的年份。在某些情况下，其他字段可能会导致选择下一或上一个大世纪，以便获得与所有给定字段一致的结果。有关详细信息，请参阅 fromString()。

注意

如果使用了月份和日期名称，则必须用地区语言的名称给出。

如果无法解析日期，则返回无效日期。

toDate(string, format[, baseYear=1900])
参数：:

  • string – str

  • format – str

  • baseYear – int

返回类型

QDate

将字符串作为指定格式的日期读取。

解析字符串并返回它所代表的日期。有关格式的解释，请参见 fromString()。

当格式仅指定年份的最后两位时，从baseYear开始的100年将是首先考虑的候选年份。在6.7之前没有baseYear参数，总是使用1900。这是baseYear的默认值，选择从那时到1999年之间的年份。在某些情况下，其他字段可能导致选择下一个或上一个大世纪，以获得与所有给定字段一致的结果。有关详细信息，请参见 fromString()。

注意

如果使用了月份和日期名称，则必须用地区语言的名称给出。

如果无法解析日期，则返回无效日期。

toDate(string, format, cal[, baseYear=1900])
参数：:

  • string – str

  • format – str

  • cal – QCalendar

  • baseYear – int

返回类型

QDate

这是一个重载函数。

toDate(string, format, cal[, baseYear=1900])
参数：:
返回类型

QDate

这是一个重载函数。

toDateTime(string, format, cal[, baseYear=1900])#
参数：:
返回类型

QDateTime

这是一个重载函数。

toDateTime(string[, format=QLocale.FormatType.LongFormat[, baseYear=1900]])
参数：:

  • string – str

  • format - FormatType

  • baseYear – int

返回类型

QDateTime

以地域特定的format格式读取字符串作为日期时间。

解析 string 并返回其所表示的日期和时间。日期字符串的格式根据 format 参数选择（见 dateFormat() }}

有些地区，特别是在 ShortFormat 的情况下，仅在年份的最后两位。在这种情况下，从 baseYear 开始的100年是首先考虑的候选人。在版本6.7之前，没有 baseYear 参数，并且始终使用1900。这是 baseYear 的默认值，选择从那时到1999年的年份。在某些情况下，其他字段可能会导致选择下一或上一个大世纪，以便获得与所有给定字段一致的结果。有关详细信息，请参阅 fromString()。

注意

如果使用月份和天文名称，必须使用地区的语言来表示。任何使用的am/pm指示符必须与 amText() 或 pmText() 匹配，忽略大小写。

如果无法解析字符串，则返回无效的 QDateTime .

toDateTime(string, format, cal[, baseYear=1900])
参数：:

  • string – str

  • format – str

  • cal – QCalendar

  • baseYear – int

返回类型

QDateTime

这是一个重载函数。

toDateTime(string, format[, baseYear=1900])
参数：:

  • string – str

  • format – str

  • baseYear – int

返回类型

QDateTime

将 string 以给定的 format 作为日期时间读取。

解析 string 并返回其表示的日期和时间。有关对 format 的解释，请参阅 fromString() 。

当格式仅指定年份的最后两位时，从baseYear开始的100年将是首先考虑的候选年份。在6.7之前没有baseYear参数，总是使用1900。这是baseYear的默认值，选择从那时到1999年之间的年份。在某些情况下，其他字段可能导致选择下一个或上一个大世纪，以获得与所有给定字段一致的结果。有关详细信息，请参见 fromString()。

注意

如果使用月份和天文名称，必须使用地区的语言来表示。任何使用的am/pm指示符必须与 amText() 或 pmText() 匹配，忽略大小写。

如果无法解析字符串，则返回无效的 QDateTime 。如果字符串可以解析但表示无效的日期时间（例如，由时区转换跳过的间隔），则返回无效的 QDateTime ，其中 toMSecsSinceEpoch() 表示一个近似的有效日期时间。将此传递给 fromMSecsSinceEpoch() 将生成一个有效的日期时间，该日期时间被解析的字符串所不忠实表示。

toDouble(s)#
参数：:

s – str

返回类型

(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)#
参数：:

s – str

返回类型

(float, bool ok)

返回由本地化字符串 s 表示的浮点数。

如果转换溢出，则返回无穷大；如果转换失败（例如，下溢），则返回 0.0。

如果 ok 不是 None，则通过将 *``ok`` 设置为 false 报告失败，通过将 *``ok`` 设置为 true 报告成功。

此函数忽略前导和尾随空白。

toInt(s)#
参数：:

s – str

返回类型

(int, bool ok)

返回由本地化字符串 s 表示的 int。

如果转换失败，函数返回 0。

如果 ok 不是 None，则通过将 *``ok`` 设置为 false 报告失败，通过将 *``ok`` 设置为 true 报告成功。

此函数忽略前导和尾随空白。

toLong(s)#
参数：:

s – str

返回类型

(int, bool ok)

返回由本地化字符串 s 表示的长整型数。

如果转换失败，函数返回 0。

如果 ok 不是 None，则通过将 *``ok`` 设置为 false 报告失败，通过将 *``ok`` 设置为 true 报告成功。

此函数忽略前导和尾随空白。

toLongLong(s)#
参数：:

s – str

返回类型

(int, bool ok)

返回由本地化字符串 s 表示的长长整型数。

如果转换失败，函数返回 0。

如果 ok 不是 None，则通过将 *``ok`` 设置为 false 报告失败，通过将 *``ok`` 设置为 true 报告成功。

此函数忽略前导和尾随空白。

toLower(str)#
参数：:

str – str

返回类型

str

返回字符串str的小写副本。

如果Qt核心使用ICU库，则将使用当前区域设置的规则执行转换。否则，转换可能以平台相关的方式完成，以toLower()作为通用回退。

参见

toLower()

toShort(s)#
参数：:

s – str

返回类型

(int, bool ok)

返回由本地化字符串s表示的短整型。

如果转换失败，函数返回 0。

如果 ok 不是 None，则通过将 *``ok`` 设置为 false 报告失败，通过将 *``ok`` 设置为 true 报告成功。

此函数忽略前导和尾随空白。

toString(i)#
参数：:

i – int

返回类型

str

这是一个重载函数。

参见

toInt()

toString(i)
参数：:

i – int

返回类型

str

返回表示i的本地化字符串。

toString(i)
参数：:

i – int

返回类型

str

这是一个重载函数。

参见

toLong()

toString(f[, format='g'[, precision=6]])
参数：:

  • f – float

  • format – int

  • precision – int

返回类型

str

这是一个重载函数。

返回表示浮点数f的字符串。

format和precision具有与toString(double, char, int)中所述相同的含义。

toString(f[, format='g'[, precision=6]])
参数：:

  • f – float

  • format – int

  • precision – int

返回类型

str

这是一个重载函数。

返回表示浮点数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(dateTime, format)
参数：:
返回类型

str

根据指定的格式，返回给定 dateTime 的本地化字符串表示。如果 format 是空字符串，则返回空字符串。

toString(dateTime[, format=QLocale.FormatType.LongFormat])
参数：:
返回类型

str

这是一个重载函数。

toString(time, format)
参数：:

  • time – QTime

  • format – str

返回类型

str

根据指定的格式，返回给定 time 的本地化字符串表示。如果 format 是空字符串，则返回空字符串。

参见

toString()

toString(time[, format=QLocale.FormatType.LongFormat])
参数：:
返回类型

str

返回给定 time 在指定 format 下的本地化字符串表示形式（见 timeFormat() ）。

toString(date, format)
参数：:

  • date – QDate

  • format – str

返回类型

str

返回给定 date 在指定 format 下的本地化字符串表示形式。如果 format 是空字符串，则返回空字符串。

参见

toString()

toString(date, format, cal)
参数：:
返回类型

str

根据指定的 format （参见 dateFormat() ）将给定 date 转换为本地化字符串表示形式，可选地为指定的日历 cal。

注意

某些地区可能使用可表示年份范围的格式受到限制。

toString(date[, format=QLocale.FormatType.LongFormat])
参数：:
返回类型

str

这是一个重载函数。

toString(dateTime, format, cal)
参数：:
返回类型

str

根据指定的 format （参见 dateTimeFormat() ）将给定 dateTime 转换为本地化字符串表示形式，可选地为指定的日历 cal。

注意

某些地区可能使用可表示年份范围的格式受到限制。

toTime(string, format)#
参数：:

  • string – str

  • format – str

返回类型

QTime

按照给定的 format 读取 string 作为时间。

解析 string 并返回它所表示的时间。有关 format 的解释，请参见 fromString()。

注意

用于表示 am/pm 的任何指示符必须与 amText() 或 pmText() 匹配，忽略大小写。

如果无法解析时间，则返回无效时间。

toTime(string[, format=QLocale.FormatType.LongFormat])
参数：:
返回类型

QTime

以特定于语言环境的格式解读string作为时间格式。

解析string并返回它表示的时间。时间字符串的格式根据format参数的选择（请参阅timeFormat()）。

注意

用于表示 am/pm 的任何指示符必须与 amText() 或 pmText() 匹配，忽略大小写。

如果无法解析时间，则返回无效时间。

toUInt(s)#
参数：:

s – str

返回类型

(int, bool ok)

返回由本地化字符串s表示的无符号整数值。

如果转换失败，函数返回 0。

如果 ok 不是 None，则通过将 *``ok`` 设置为 false 报告失败，通过将 *``ok`` 设置为 true 报告成功。

此函数忽略前导和尾随空白。

toULong(s[, ok=None])#
参数：:

  • s – str

  • ok – bool

返回类型

int

返回由本地化字符串s表示的无符号长整型值。

如果转换失败，函数返回 0。

如果 ok 不是 None，则通过将 *``ok`` 设置为 false 报告失败，通过将 *``ok`` 设置为 true 报告成功。

此函数忽略前导和尾随空白。

toULongLong(s)#
参数：:

s – str

返回类型

(int, bool ok)

返回由本地化字符串s表示的无符号长长整型值。

如果转换失败，函数返回 0。

如果 ok 不是 None，则通过将 *``ok`` 设置为 false 报告失败，通过将 *``ok`` 设置为 true 报告成功。

此函数忽略前导和尾随空白。

toUShort(s)#
参数：:

s – str

返回类型

(int, bool ok)

返回由本地化字符串 s 表示的无符号短整型。

如果转换失败，函数返回 0。

如果 ok 不是 None，则通过将 *``ok`` 设置为 false 报告失败，通过将 *``ok`` 设置为 true 报告成功。

此函数忽略前导和尾随空白。

toUpper(str)#
参数：:

str – str

返回类型

str

返回 str 的上档副本。

如果 Qt Core 使用 ICU 库，则将根据当前区域设置的规则使用这些库来执行转换。否则，转换可能会以依赖于平台的方式进行，其中 toUpper() 用于通用回退。

参见

toUpper()

uiLanguages([separator=QLocale.TagSeparator.Dash])#
参数：:

separator – TagSeparator

返回类型

字符串列表

用于选择翻译的区域设置名称列表

返回列表中的每个条目都是适合用户偏好的 UI 翻译区域设置的名称。如果列表中的名称由多个标签组成，则它们将与 separator 指示的方式连接。在 Qt 6.7 之前使用破折号作为分隔符。

例如，使用默认分隔符 Dash，如果用户已将系统配置为使用美国英语，则列表将包含“en-Latn-US”、“en-US”、“en”。条目的顺序是检查翻译的顺序；列表中的早期条目应优先于较晚的条目。如果您的翻译文件使用下划线而不是破折号分隔区域标签，请将 Underscore 作为 separator 传递。

很可能您不需要直接使用此函数，只需将 QLocale 对象传递给 load() 函数即可。

weekdays()#
返回类型

表示为数组的Qt.DayOfWeek

返回当前区域设置的星期工作日列表。

zeroDigit()#
返回类型

str

返回该区域的零数字符。

这通常是一个单一的Unicode字符，但也可能被编码为一个代理对，因此自Qt 6.0以来以字符串形式返回。在大多数区域中，其他数字按照Unicode顺序跟随它 - 然而，一些数字系统，特别是使用U+3007作为零的系统，没有连续的数字。使用toString()来获取合适的数字表示，而不是从该零数字符构建它们。

参见

toString()