PySide6.QtCore.QLocale

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 的数据基于通用区域数据存储库 v45。

匹配语言、文字和地区的组合

QLocale 拥有从CLDR派生的数据,涵盖了许多语言、文字和地区的组合,但并非全部。如果它是在指定了这三个关键值的情况下构建的(将AnyLanguageAnyScriptAnyTerritory视为未指定),并且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

此枚举描述了将QDateQTimeQDateTime对象以及月份和日期转换为特定于区域设置的字符串时可以使用的不同格式。

常量

描述

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, …

另请参阅

formattedDataSize()

class LanguageCodeType

(继承自 enum.IntFlag) 此枚举定义了可用于限制 codeToLanguagelanguageToCode 所考虑的语言代码集合的语言代码类型。

常量

描述

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

如果设置了此选项,将使用替代引号来引用字符串。

另请参阅

quoteString()

在版本4.8中添加。

PySide6.QtCore.QLocale.DefaultTwoDigitBaseYear
__init__()

构造一个使用默认区域设置初始化的QLocale对象。

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

另请参阅

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

这是一个重载函数。

__init__(language, territory)
Parameters:

为指定的languageterritory构造一个QLocale对象。

如果此组合使用了多个脚本,将选择一个可能的脚本。如果QLocale没有指定language的数据,则使用默认的区域设置。如果QLocale没有指定languageterritory组合的数据,则可能会使用替代的territory。

另请参阅

setDefault() 匹配 语言、 脚本 地区的 组合

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

为指定的languagescriptterritory构造一个QLocale对象。

如果 QLocale 没有给定组合的数据,它将尽可能找到最佳匹配的数据。如果没有找到,它将回退到默认的区域设置。

  • languageAnyLanguage,并且无法从 scriptterritory 推断出语言

  • QLocale 没有该语言的数据,无论是作为 language 给出还是如上所述推断。

另请参阅

setDefault() 匹配 语言、 脚本 地区的 组合

amText()
Return type:

字符串

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

另请参阅

pmText()

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

static c()
Return type:

QLocale

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

此区域设置基于en_US,但具有其自身的各种特点,例如简化的数字格式和其自己的日期格式。它实现了描述“C”编程语言标准库函数行为的POSIX标准。

除此之外,这意味着其排序顺序基于字母的ASCII值,因此(对于区分大小写的排序)所有大写字母在任何小写字母之前排序(而不是每个字母的大写和小写形式相邻排序,然后再是下一个字母的两种形式)。

另请参阅

system()

static codeToCountry(countryCode)
Parameters:

countryCode – str

Return type:

国家

注意

此函数已弃用。

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

如果代码无效或未知,则返回AnyTerritory

请使用 codeToTerritory ( QStringView ) 代替。

static codeToLanguage(languageCode[, codeTypes=QLocale.LanguageCodeType.AnyLanguageCode])
Parameters:
Return type:

语言

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

如果指定了codeTypes,则选择要考虑转换的代码集。默认情况下,Qt已知的所有代码都会被考虑。代码按以下顺序匹配:ISO639Part1ISO639Part2BISO639Part2TISO639Part3LegacyLanguageCode

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

static codeToScript(scriptCode)
Parameters:

scriptCode – str

Return type:

Script

返回与四字母脚本代码scriptCode对应的Script枚举,如ISO 15924标准中所定义。

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

static codeToTerritory(territoryCode)
Parameters:

territoryCode – str

Return type:

国家

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

如果代码无效或未知,则返回AnyTerritory

collation()
Return type:

QLocale

返回用于排序的区域设置。

结果通常是这个区域设置;然而,系统区域设置(通常是默认区域设置)将返回系统排序区域设置。结果适合传递给QCollator的构造函数。

另请参阅

QCollator

static countriesForLanguage(lang)
Parameters:

lang语言

Return type:

QLocale.Country的列表

注意

此函数已弃用。

使用 matchingLocales() 代替,并查阅每个的 territory()

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

另请参阅

matchingLocales()

country()
Return type:

国家

注意

此函数已弃用。

请使用 territory() 代替。

返回此区域设置的地区。

static countryToCode(country)
Parameters:

国家Country

Return type:

字符串

注意

此函数已弃用。

请使用territoryToCode()代替。

返回country的两个字母的领土代码,如ISO 3166标准中所定义。

注意

对于 QLocale::AnyTerritoryQLocale::AnyCountry,将返回一个空字符串。

static countryToString(country)
Parameters:

国家Country

Return type:

字符串

注意

此函数已弃用。

请使用territoryToString()代替。

返回一个包含country名称的QString

createSeparatedList(strl)
Parameters:

strl – 字符串列表

Return type:

字符串

返回一个字符串,该字符串表示使用由区域设置定义的分隔符连接的给定list字符串列表。

currencySymbol([format=QLocale.CurrencySymbolFormat.CurrencySymbol])
Parameters:

formatCurrencySymbolFormat

Return type:

字符串

根据format返回一个货币符号。

dateFormat([format=QLocale.FormatType.LongFormat])
Parameters:

格式FormatType

Return type:

字符串

返回用于当前区域设置的日期格式。

如果 formatLongFormat,格式将会是详细的,否则将会是简短的。例如,对于 en_US 区域设置,LongFormatdddd, MMMM d, yyyyShortFormatM/d/yy

另请参阅

toString() fromString()

dateTimeFormat([format=QLocale.FormatType.LongFormat])
Parameters:

格式FormatType

Return type:

字符串

返回用于当前区域设置的日期时间格式。

如果 formatLongFormat,格式将会是详细的,否则将会是简短的。例如,对于 en_US 区域设置,LongFormatdddd, MMMM d, yyyy h:mm:ss AP tShortFormatM/d/yy h:mm AP

另请参阅

toString() fromString()

dayName(day[, format=QLocale.FormatType.LongFormat])
Parameters:
Return type:

字符串

返回day的本地化名称(其中1代表星期一,2代表星期二,依此类推),格式由type指定。

例如,如果区域设置为en_USday为1,LongFormat将返回MondayShortFormat返回Mon,而NarrowFormat返回M

decimalPoint()
Return type:

字符串

返回此语言环境的小数部分分隔符。

这是在有小数部分的数字表示中,将整数部分与小数部分分隔开的标记。这通常被称为“小数点字符”——尽管在许多地区,它并不是一个“点”(或类似的点)。自Qt 6.0起,它被返回为一个字符串,以防某些地区需要多个UTF-16代码点来表示其分隔符。

exponential()
Return type:

字符串

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

这是一个用于在某些浮点数表示中将尾数与指数分开的标记。自Qt 6.0起,它作为字符串返回,因为在某些区域设置中,它不是一个单一字符——例如,它可能由一个乘号和一个“十的幂”运算符的表示组成。

另请参阅

toString(double, char, int)

firstDayOfWeek()
Return type:

DayOfWeek

根据当前区域设置返回一周的第一天。

formattedDataSize(bytes[, precision=2[, format=QLocale.DataSizeFormat.DataSizeIecFormat]])
Parameters:
Return type:

字符串

将字节大小转换为人类可读的本地化字符串,包括一个数字和一个量化的单位。选择量词使得数字至少为一,并且尽可能小。例如,如果bytes是16384,precision是2,formatDataSizeIecFormat(默认值),此函数返回“16.00 KiB”;对于1330409069609字节,它返回“1.21 GiB”;依此类推。如果formatDataSizeIecFormatDataSizeTraditionalFormat,给定的字节数除以1024的幂,结果小于1024;对于DataSizeSIFormat,它除以1000的幂,结果小于1000。DataSizeIecFormat使用新的IEC标准量词Ki、Mi等,而DataSizeSIFormat使用旧的SI量词k、M等,DataSizeTraditionalFormat则滥用它们。

groupSeparator()
Return type:

字符串

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

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

另请参阅

decimalPoint() toString()

language()
Return type:

语言

返回此区域设置的语言。

static languageToCode(language[, codeTypes=QLocale.LanguageCodeType.AnyLanguageCode])
Parameters:
Return type:

字符串

返回language的两字母或三字母语言代码,如ISO 639标准中所定义。

如果指定了codeTypes,则选择要考虑的代码集。返回为language定义的集合中的第一个代码。否则,将考虑所有ISO-639代码。代码按以下顺序考虑:ISO639Part1ISO639Part2BISO639Part2TISO639Part3LegacyLanguageCode被此函数忽略。

注意

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

static languageToString(language)
Parameters:

语言Language

Return type:

字符串

返回一个包含language名称的QString

static matchingLocales(language, script, territory)
Parameters:
Return type:

QLocale的列表

返回与给定的languagescriptterritory匹配的有效区域设置对象的列表。

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

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

measurementSystem()
Return type:

MeasurementSystem

返回区域设置的测量系统。

monthName(month[, format=QLocale.FormatType.LongFormat])
Parameters:
Return type:

字符串

返回month的本地化名称,格式由type指定。

例如,如果区域设置为en_USmonth为1,LongFormat将返回JanuaryShortFormat 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()以及类似的脚本和区域来构造您想要标识的区域设置字符串。

nativeCountryName()
Return type:

字符串

注意

此函数已弃用。

请使用nativeTerritoryName()代替。

返回该地区的本地名称。例如,西班牙/西班牙地区的名称为“España”。

nativeLanguageName()
Return type:

字符串

返回语言环境的本地语言名称。例如,瑞士德语语言环境的“Schweizer Hochdeutsch”。

nativeTerritoryName()
Return type:

字符串

返回该地区的本地名称。例如,西班牙/西班牙地区的名称为“España”。

negativeSign()
Return type:

字符串

返回此区域设置的负号指示符。

这是一个假定用作数字前缀以表示其为负数的标记。自Qt 6.0起,它作为字符串返回,因为在某些区域设置中,它不是一个单一字符——例如,因为它包含一个文本方向控制字符。

另请参阅

positiveSign() toString()

numberOptions()
Return type:

NumberOption的组合

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

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

__ne__(rhs)
Parameters:

rhsQLocale

Return type:

布尔

如果两个QLocale对象lhsrhs不同,则返回true;否则返回false

注意

系统区域设置不等于从其language()script()territory()构造的QLocale对象,即使两者在所有数据字段中都一致。具有不同数字选项的两个区域设置也不相等。

另请参阅

operator==() setNumberOptions()

__ne__(lhs)
Parameters:

lhs语言

Return type:

布尔

__ne__(rhs)
Parameters:

rhs语言

Return type:

布尔

__eq__(rhs)
Parameters:

rhsQLocale

Return type:

布尔

如果两个QLocale对象lhsrhs相同,则返回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起,它作为字符串返回,因为在某些语言环境中,它不是一个单一字符——例如,因为它包含一个文本方向控制字符。

另请参阅

toString()

pmText()
Return type:

字符串

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

另请参阅

amText()

positiveSign()
Return type:

字符串

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

这是一个假定用作数字前缀以表示其为正数的标记。自Qt 6.0起,它作为字符串返回,因为在某些区域设置中,它不是一个单一字符——例如,因为它包含一个文本方向控制字符。

另请参阅

negativeSign() toString()

quoteString(str[, style=QLocale.QuotationStyle.StandardQuotation])
Parameters:
Return type:

字符串

这是一个重载函数。

quoteString(str[, style=QLocale.QuotationStyle.StandardQuotation])
Parameters:
Return type:

字符串

根据当前区域设置,使用给定的引用style返回str的引用形式。

script()
Return type:

Script

返回此区域设置的脚本。

static scriptToCode(script)
Parameters:

脚本Script

Return type:

字符串

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

注意

对于QLocale::AnyScript,返回一个空字符串。

static scriptToString(script)
Parameters:

脚本Script

Return type:

字符串

返回一个包含script名称的QString

static setDefault(locale)
Parameters:

localeQLocale

将全局默认区域设置设置为locale。当QLocale对象在没有参数的情况下构造时,将使用这些值。如果未调用此函数,则使用系统的区域设置。

警告

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

另请参阅

system() c()

setNumberOptions(options)
Parameters:

optionsNumberOption 的组合

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

standaloneDayName(day[, format=QLocale.FormatType.LongFormat])
Parameters:
Return type:

字符串

返回day的本地化名称(其中1代表星期一,2代表星期二,依此类推),该名称用作独立文本,格式由type指定。

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

standaloneMonthName(month[, format=QLocale.FormatType.LongFormat])
Parameters:
Return type:

字符串

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

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

swap(other)
Parameters:

其他QLocale

将本地化设置 other 与此本地化设置交换。此操作非常快速且永远不会失败。

static system()
Return type:

QLocale

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

系统区域设置可能会使用系统特定的来源来获取区域数据,如果可用的话,否则会回退到QLocale的内置数据库条目,该条目对应于系统报告的语言、文字和地区。

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

注意

在macOS上,Qt for Python不会通过QLocale::system()反映用户的区域和语言偏好,而是会反映POSIX用于指定区域设置的环境变量,类似于Python的locale模块。如果无法确定系统区域设置,可能是由于您的环境没有设置变量'LC_ALL'、'LC_CTYPE'、'LANG'或'LANGUAGE',那么将返回默认的POSIX区域设置或'C'区域设置。

另请参见 c()。

territory()
Return type:

国家

返回此区域设置的地区。

static territoryToCode(territory)
Parameters:

地区国家

Return type:

字符串

返回territory的两个字母的地区代码,该代码定义在ISO 3166标准中。

注意

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

static territoryToString(territory)
Parameters:

地区国家

Return type:

字符串

返回一个包含territory名称的QString

textDirection()
Return type:

LayoutDirection

返回语言的文本方向。

timeFormat([format=QLocale.FormatType.LongFormat])
Parameters:

格式FormatType

Return type:

字符串

返回用于当前区域设置的时间格式。

如果 formatLongFormat,格式将会是详细的,否则将会是简短的。例如,对于 en_US 区域设置,LongFormath:mm:ss AP tShortFormath:mm AP

另请参阅

toString() fromString()

toCurrencyString(i[, symbol=""])
Parameters:
  • i – 整数

  • symbol – str

Return type:

字符串

这是一个重载函数。

toCurrencyString(value[, symbol=""])
Parameters:
  • value – int

  • symbol – str

Return type:

字符串

返回value作为货币的本地化字符串表示。如果提供了symbol,则使用它代替默认的货币符号。

另请参阅

currencySymbol()

toCurrencyString(value[, symbol=""[, precision=-1]])
Parameters:
  • value – 浮点数

  • symbol – str

  • precision – int

Return type:

字符串

此函数重载了 toCurrencyString()

返回value作为货币的本地化字符串表示。如果提供了symbol,则使用它代替默认的货币符号。如果提供了precision,则使用它来设置货币值的精度。

另请参阅

currencySymbol()

toCurrencyString(i[, symbol=""[, precision=-1]])
Parameters:
  • i – 浮点数

  • symbol – str

  • precision – int

Return type:

字符串

此函数重载了 toCurrencyString()

toDate(string[, format=QLocale.FormatType.LongFormat[, baseYear=1900]])
Parameters:
  • 字符串 – str

  • formatFormatType

  • baseYear – int

Return type:

QDate

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:

QDate

string读取为给定format格式的日期。

解析 string 并返回其表示的日期。有关 format 的解释,请参见 fromString()

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

注意

月份和日期的名称,在使用时,必须使用本地语言。

如果日期无法解析,则返回一个无效日期。

toDate(string, format, cal[, baseYear=1900])
Parameters:
Return type:

QDate

这是一个重载函数。

toDate(string, format, cal[, baseYear=1900])
Parameters:
  • 字符串 – str

  • format – str

  • calQCalendar

  • baseYear – int

Return type:

QDate

这是一个重载函数。

toDateTime(string[, format=QLocale.FormatType.LongFormat[, baseYear=1900]])
Parameters:
  • 字符串 – str

  • formatFormatType

  • baseYear – int

Return type:

QDateTime

string读取为特定语言环境的format中的日期时间。

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

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

注意

月份和日期的名称,如果使用,必须使用本地语言。任何使用的上午/下午指示符必须与amText()pmText()匹配,忽略大小写。

如果字符串无法解析,则返回一个无效的 QDateTime

toDateTime(string, format[, baseYear=1900])
Parameters:
  • 字符串 – str

  • format – str

  • baseYear – int

Return type:

QDateTime

string读取为给定format格式的日期时间。

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

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

注意

月份和日期的名称,如果使用,必须使用本地语言。任何使用的上午/下午指示符必须与amText()pmText()匹配,忽略大小写。

如果字符串无法解析,则返回一个无效的QDateTime。如果字符串可以解析但表示一个无效的日期时间(例如在时区转换跳过的间隔中),则返回一个无效的QDateTime,其toMSecsSinceEpoch()表示一个附近的有效日期时间。将其传递给fromMSecsSinceEpoch()将生成一个有效的日期时间,但该日期时间无法通过解析的字符串准确表示。

toDateTime(string, format, cal[, baseYear=1900])
Parameters:
Return type:

QDateTime

这是一个重载函数。

toDateTime(string, format, cal[, baseYear=1900])
Parameters:
  • 字符串 – str

  • format – str

  • calQCalendar

  • baseYear – int

Return type:

QDateTime

这是一个重载函数。

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 来报告成功。

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

另请参阅

toUInt() toString()

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 来报告成功。

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

另请参阅

toUShort() toString()

toString(i)
Parameters:

i – 整数

Return type:

字符串

这是一个重载函数。

另请参阅

toInt()

toString(i)
Parameters:

i – 整数

Return type:

字符串

这是一个重载函数。

另请参阅

toLong()

toString(i)
Parameters:

i – 整数

Return type:

字符串

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

toString(date[, format=QLocale.FormatType.LongFormat])
Parameters:
Return type:

字符串

这是一个重载函数。

toString(date, format)
Parameters:
  • 日期QDate

  • format – str

Return type:

字符串

返回给定date在指定format中的本地化字符串表示。如果format为空字符串,则返回空字符串。

另请参阅

toString()

toString(time[, format=QLocale.FormatType.LongFormat])
Parameters:
Return type:

字符串

返回给定time在指定format中的本地化字符串表示(参见timeFormat())。

toString(time, format)
Parameters:
  • 时间QTime

  • format – str

Return type:

字符串

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

另请参阅

toString()

toString(dateTime[, format=QLocale.FormatType.LongFormat])
Parameters:
Return type:

字符串

这是一个重载函数。

toString(dateTime, format)
Parameters:
Return type:

字符串

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

toString(date, format, cal)
Parameters:
Return type:

字符串

返回给定date的本地化字符串表示,根据指定的format(参见dateFormat()),可选地用于指定的日历cal

注意

某些地区可能使用的格式限制了它们可以表示的年份范围。

toString(dateTime, format, cal)
Parameters:
Return type:

字符串

返回给定dateTime的本地化字符串表示,根据指定的format(参见dateTimeFormat()),可选地用于指定的日历cal

注意

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

toString(f[, format='g'[, precision=6]])
Parameters:
  • f – 浮点数

  • format – int

  • precision – int

Return type:

字符串

这是一个重载函数。

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

表示形式由formatprecision参数控制。

format 默认为 'g'。它可以是以下任意一种:

格式

含义

precision 的含义

'e'

格式为 [-]9.9e[+|-]999

小数点后的位数

'E'

格式为 [-]9.9E[+|-]999

'f'

格式化为 [-]9.9

'F'

'f' 相同,除了 INF 和 NAN(见下文)

'g'

使用 'e''f' 格式,选择更简洁的一种

最大有效数字位数(尾随零被省略)

'G'

使用 'E''F' 格式,选择更简洁的

特殊的 precisionFloatingPointShortest 选择最短的表示形式,当作为数字读取时,可以恢复原始的浮点值。除此之外,任何负的 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 的字符串。

formatprecision 的含义与 toString(double, char, int) 中描述的含义相同。

toTime(string[, format=QLocale.FormatType.LongFormat])
Parameters:
Return type:

QTime

读取string作为特定地区的时间format

解析 string 并返回其表示的时间。时间字符串的格式根据 format 参数选择(参见 timeFormat() )。

注意

使用的任何上午/下午指示符必须与amText()pmText()匹配,忽略大小写。

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

toTime(string, format)
Parameters:
  • 字符串 – str

  • format – str

Return type:

QTime

string读取为给定format中的时间。

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

注意

使用的任何上午/下午指示符必须与amText()pmText()匹配,忽略大小写。

如果时间无法解析,则返回一个无效的时间。

toUInt(s)
Parameters:

s – 字符串

Return type:

(int, bool ok)

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

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

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

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

另请参阅

toInt() toString()

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 来报告成功。

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

另请参阅

toShort() toString()

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()函数即可。

另请参阅

QTranslator bcp47Name()

weekdays()
Return type:

Qt.DayOfWeek的列表

返回根据当前区域设置被视为工作日的日期列表。

zeroDigit()
Return type:

字符串

返回此语言环境的零数字字符。

这是一个单一的Unicode字符,但可能被编码为代理对,因此(自Qt 6.0起)作为字符串返回。在大多数语言环境中,其他数字在Unicode顺序中紧随其后 - 然而,一些数字系统,特别是那些使用U+3007作为零的系统,没有连续的数字。使用toString()来获取数字的合适表示,而不是尝试从这个零数字构造它们。

另请参阅

toString()