IdentifiantMot de passe
Loading...
Mot de passe oublié ?Je m'inscris ! (gratuit)

QLocale Class

L'auteur

Liens sociaux

Viadeo Twitter Facebook Share on Google+   

QLocale Class

  • Header: QLocale

  • CMake:

    find_package(Qt6 REQUIRED COMPONENTS Core)

    target_link_libraries(mytarget PRIVATE Qt6::Core)

  • qmake: QT += core

  • Inherited By:

  • Group: QLocale is part of i18n, string-processing, Implicitly Shared Classes

Detailed Description

QLocale is initialized with a language/country pair in its constructor and offers number-to-string and string-to-number conversion functions similar to those in QString.

Example:

 
Sélectionnez
QLocale egyptian(QLocale::Arabic, QLocale::Egypt);
QString s1 = egyptian.toString(1.571429E+07, 'e');
QString s2 = egyptian.toString(10);

double d = egyptian.toDouble(s1);
int i = egyptian.toInt(s2);

QLocale supports the concept of a default locale, which is determined from the system's locale settings at application startup. The default locale can be changed by calling the static member setDefault(). Setting the default locale has the following effects:

  • If a QLocale object is constructed with the default constructor, it will use the default locale's settings.

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

  • QString::arg() uses the default locale to format a number when its position specifier in the format string contains an 'L', e.g. "%L1".

The following example illustrates how to use QLocale directly:

 
Sélectionnez
QLocale::setDefault(QLocale(QLocale::Hebrew, QLocale::Israel));
QLocale hebrew; // Constructs a default QLocale
QString s1 = hebrew.toString(15714.3, 'e');

bool ok;
double d;

QLocale::setDefault(QLocale::C);
d = QString("1234,56").toDouble(&ok);   // ok == false, d == 0
d = QString("1234.56").toDouble(&ok);   // ok == true,  d == 1234.56

QLocale::setDefault(QLocale::German);
d = QString("1234,56").toDouble(&ok);   // ok == false, d == 0
d = QString("1234.56").toDouble(&ok);   // ok == true,  d == 1234.56

QLocale::setDefault(QLocale(QLocale::English, QLocale::UnitedStates));
QString str = QString("%1 %L2 %L3")
      .arg(12345).arg(12345).arg(12345, 0, 16);
// str == "12345 12,345 3039"

When a language/country pair is specified in the constructor, one of three things can happen:

  • If the language/country pair is found in the database, it is used.

  • If the language is found but the country is not, or if the country is AnyCountry, the language is used with the most appropriate available country (for example, Germany for German),

  • If neither the language nor the country are found, QLocale defaults to the default locale (see setDefault()).

Use language() and country() to determine the actual language and country values used.

An alternative method for constructing a QLocale object is by specifying the locale name.

 
Sélectionnez
QLocale korean("ko");
QLocale swiss("de_CH");

This constructor converts the locale name to a language/country pair; it does not use the system locale database.

For the current keyboard input locale take a look at QInputMethod::locale().

QLocale's data is based on Common Locale Data Repository v38.

See Also

Member Type Documentation

 

enum QLocale::Country

This enumerated type is used to specify a country.

Constant

Value

QLocale::AnyCountry

0

 

QLocale::Afghanistan

1

 

QLocale::AlandIslands

2

 

QLocale::Albania

3

 

QLocale::Algeria

4

 

QLocale::AmericanSamoa

5

 

QLocale::Andorra

6

 

QLocale::Angola

7

 

QLocale::Anguilla

8

 

QLocale::Antarctica

9

 

QLocale::AntiguaAndBarbuda

10

 

QLocale::Argentina

11

 

QLocale::Armenia

12

 

QLocale::Aruba

13

 

QLocale::AscensionIsland

14

 

QLocale::Australia

15

 

QLocale::Austria

16

 

QLocale::Azerbaijan

17

 

QLocale::Bahamas

18

 

QLocale::Bahrain

19

 

QLocale::Bangladesh

20

 

QLocale::Barbados

21

 

QLocale::Belarus

22

 

QLocale::Belgium

23

 

QLocale::Belize

24

 

QLocale::Benin

25

 

QLocale::Bermuda

26

 

QLocale::Bhutan

27

 

QLocale::Bolivia

28

 

QLocale::Bonaire

CaribbeanNetherlands

 

QLocale::BosniaAndHerzegowina

BosniaAndHerzegovina

Obsolete, use BosniaAndHerzegovina instead

QLocale::BosniaAndHerzegovina

29

Since 6.0

QLocale::Botswana

30

 

QLocale::BouvetIsland

31

 

QLocale::Brazil

32

 

QLocale::BritishIndianOceanTerritory

33

 

QLocale::BritishVirginIslands

34

 

QLocale::Brunei

35

 

QLocale::Bulgaria

36

 

QLocale::BurkinaFaso

37

 

QLocale::Burundi

38

 

QLocale::Cambodia

39

 

QLocale::Cameroon

40

 

QLocale::Canada

41

 

QLocale::CanaryIslands

42

 

QLocale::CaribbeanNetherlands

44

 

QLocale::CapeVerde

43

 

QLocale::CaymanIslands

45

 

QLocale::CentralAfricanRepublic

46

 

QLocale::CeutaAndMelilla

47

 

QLocale::Chad

48

 

QLocale::Chile

49

 

QLocale::China

50

 

QLocale::ChristmasIsland

51

 

QLocale::ClippertonIsland

52

 

QLocale::CocosIslands

53

 

QLocale::Colombia

54

 

QLocale::Comoros

55

 

QLocale::CongoBrazzaville

56

 

QLocale::CongoKinshasa

57

 

QLocale::CookIslands

58

 

QLocale::CostaRica

59

 

QLocale::Croatia

60

 

QLocale::Cuba

61

 

QLocale::Curacao

62

Since Qt 6.0

QLocale::CuraSao

Curacao

Obsolete, use Curacao instead

QLocale::Cyprus

63

 

QLocale::Czechia

64

Since 6.0

QLocale::CzechRepublic

Czechia

Obsolete, use Czechia instead

QLocale::DemocraticRepublicOfCongo

CongoKinshasa

Obsolete, use CongoKinshasa instead

QLocale::DemocraticRepublicOfKorea

NorthKorea

Obsolete, use NorthKorea instead

QLocale::Denmark

65

 

QLocale::DiegoGarcia

66

 

QLocale::Djibouti

67

 

QLocale::Dominica

68

 

QLocale::DominicanRepublic

69

 

QLocale::EastTimor

TimorLeste

 

QLocale::Ecuador

70

 

QLocale::Egypt

71

 

QLocale::ElSalvador

72

 

QLocale::EquatorialGuinea

73

 

QLocale::Eritrea

74

 

QLocale::Estonia

75

 

QLocale::Eswatini

76

 

QLocale::Ethiopia

77

 

QLocale::EuropeanUnion

79

Since Qt 5.7

QLocale::Europe

78

Since Qt 5.12

QLocale::FalklandIslands

80

 

QLocale::FaroeIslands

81

 

QLocale::Fiji

82

 

QLocale::Finland

83

 

QLocale::France

84

 

QLocale::FrenchGuiana

85

 

QLocale::FrenchPolynesia

86

 

QLocale::FrenchSouthernTerritories

87

 

QLocale::Gabon

88

 

QLocale::Gambia

89

 

QLocale::Georgia

90

 

QLocale::Germany

91

 

QLocale::Ghana

92

 

QLocale::Gibraltar

93

 

QLocale::Greece

94

 

QLocale::Greenland

95

 

QLocale::Grenada

96

 

QLocale::Guadeloupe

97

 

QLocale::Guam

98

 

QLocale::Guatemala

99

 

QLocale::Guernsey

100

 

QLocale::Guinea

102

 

QLocale::GuineaBissau

101

 

QLocale::Guyana

103

 

QLocale::Haiti

104

 

QLocale::HeardAndMcDonaldIslands

105

 

QLocale::Honduras

106

 

QLocale::HongKong

107

 

QLocale::Hungary

108

 

QLocale::Iceland

109

 

QLocale::India

110

 

QLocale::Indonesia

111

 

QLocale::Iran

112

 

QLocale::Iraq

113

 

QLocale::Ireland

114

 

QLocale::IsleOfMan

115

 

QLocale::Israel

116

 

QLocale::Italy

117

 

QLocale::IvoryCoast

118

 

QLocale::Jamaica

119

 

QLocale::Japan

120

 

QLocale::Jersey

121

 

QLocale::Jordan

122

 

QLocale::Kazakhstan

123

 

QLocale::Kenya

124

 

QLocale::Kiribati

125

 

QLocale::Kosovo

126

Since Qt 5.2

QLocale::Kuwait

127

 

QLocale::Kyrgyzstan

128

 

QLocale::Laos

129

 

QLocale::LatinAmerica

130

 

QLocale::LatinAmericaAndTheCaribbean

LatinAmerica

Obsolete, use LatinAmerica instead

QLocale::Latvia

131

 

QLocale::Lebanon

132

 

QLocale::Lesotho

133

 

QLocale::Liberia

134

 

QLocale::Libya

135

 

QLocale::Liechtenstein

136

 

QLocale::Lithuania

137

 

QLocale::Luxembourg

138

 

QLocale::Macao

139

 

QLocale::Macau

Macao

 

QLocale::Macedonia

140

 

QLocale::Madagascar

141

 

QLocale::Malawi

142

 

QLocale::Malaysia

143

 

QLocale::Maldives

144

 

QLocale::Mali

145

 

QLocale::Malta

146

 

QLocale::MarshallIslands

147

 

QLocale::Martinique

148

 

QLocale::Mauritania

149

 

QLocale::Mauritius

150

 

QLocale::Mayotte

151

 

QLocale::Mexico

152

 

QLocale::Micronesia

153

 

QLocale::Moldova

154

 

QLocale::Monaco

155

 

QLocale::Mongolia

156

 

QLocale::Montenegro

157

 

QLocale::Montserrat

158

 

QLocale::Morocco

159

 

QLocale::Mozambique

160

 

QLocale::Myanmar

161

 

QLocale::Namibia

162

 

QLocale::NauruCountry

163

 

QLocale::Nepal

164

 

QLocale::Netherlands

165

 

QLocale::NewCaledonia

166

 

QLocale::NewZealand

167

 

QLocale::Nicaragua

168

 

QLocale::Niger

170

 

QLocale::Nigeria

169

 

QLocale::Niue

171

 

QLocale::NorfolkIsland

172

 

QLocale::NorthernMarianaIslands

173

 

QLocale::NorthKorea

174

 

QLocale::Norway

175

 

QLocale::Oman

176

 

QLocale::OutlyingOceania

177

Since Qt 5.7

QLocale::Pakistan

178

 

QLocale::Palau

179

 

QLocale::PalestinianTerritories

180

 

QLocale::Panama

181

 

QLocale::PapuaNewGuinea

182

 

QLocale::Paraguay

183

 

QLocale::PeoplesRepublicOfCongo

CongoBrazzaville

Obsolete, use CongoBrazzaville instead

QLocale::Peru

184

 

QLocale::Philippines

185

 

QLocale::Pitcairn

186

 

QLocale::Poland

187

 

QLocale::Portugal

188

 

QLocale::PuertoRico

189

 

QLocale::Qatar

190

 

QLocale::RepublicOfKorea

SouthKorea

Obsolete, use SouthKorea instead

QLocale::Reunion

191

 

QLocale::Romania

192

 

QLocale::RussianFederation

Russia

 

QLocale::Russia

193

 

QLocale::Rwanda

194

 

QLocale::SaintBarthelemy

195

 

QLocale::SaintHelena

196

 

QLocale::SaintKittsAndNevis

197

 

QLocale::SaintLucia

198

 

QLocale::SaintMartin

199

 

QLocale::SaintPierreAndMiquelon

200

 

QLocale::SaintVincentAndGrenadines

201

 

QLocale::SaintVincentAndTheGrenadines

SaintVincentAndGrenadines

 

QLocale::Samoa

202

 

QLocale::SanMarino

203

 

QLocale::SaoTomeAndPrincipe

204

 

QLocale::SaudiArabia

205

 

QLocale::Senegal

206

 

QLocale::Serbia

207

 

QLocale::Seychelles

208

 

QLocale::SierraLeone

209

 

QLocale::Singapore

210

 

QLocale::SintMaarten

211

 

QLocale::Slovakia

212

 

QLocale::Slovenia

213

 

QLocale::SolomonIslands

214

 

QLocale::Somalia

215

 

QLocale::SouthAfrica

216

 

QLocale::SouthGeorgiaAndSouthSandwichIslands

217

 

QLocale::SouthGeorgiaAndTheSouthSandwichIslands

SouthGeorgiaAndSouthSandwichIslands

 

QLocale::SouthKorea

218

 

QLocale::SouthSudan

219

 

QLocale::Spain

220

 

QLocale::SriLanka

221

 

QLocale::Sudan

222

 

QLocale::Suriname

223

 

QLocale::SvalbardAndJanMayen

224

 

QLocale::SvalbardAndJanMayenIslands

SvalbardAndJanMayen

 

QLocale::Swaziland

Eswatini

 

QLocale::Sweden

225

 

QLocale::Switzerland

226

 

QLocale::Syria

227

 

QLocale::SyrianArabRepublic

Syria

Obsolete, use Syria instead

QLocale::Taiwan

228

 

QLocale::Tajikistan

229

 

QLocale::Tanzania

230

 

QLocale::Thailand

231

 

QLocale::TimorLeste

232

 

QLocale::Togo

233

 

QLocale::TokelauCountry

234

 

QLocale::Tonga

235

 

QLocale::TrinidadAndTobago

236

 

QLocale::TristanDaCunha

237

 

QLocale::Tunisia

238

 

QLocale::Turkey

239

 

QLocale::Turkmenistan

240

 

QLocale::TurksAndCaicosIslands

241

 

QLocale::TuvaluCountry

242

 

QLocale::Uganda

243

 

QLocale::Ukraine

244

 

QLocale::UnitedArabEmirates

245

 

QLocale::UnitedKingdom

246

 

QLocale::UnitedStates

248

 

QLocale::UnitedStatesOutlyingIslands

247

 

QLocale::UnitedStatesMinorOutlyingIslands

UnitedStatesOutlyingIslands

 

QLocale::UnitedStatesVirginIslands

249

 

QLocale::Uruguay

250

 

QLocale::Uzbekistan

251

 

QLocale::Vanuatu

252

 

QLocale::VaticanCity

253

 

QLocale::VaticanCityState

VaticanCity

 

QLocale::Venezuela

254

 

QLocale::Vietnam

255

 

QLocale::WallisAndFutuna

256

 

QLocale::WallisAndFutunaIslands

WallisAndFutuna

 

QLocale::WesternSahara

257

 

QLocale::World

258

Since Qt 5.12

QLocale::Yemen

259

 

QLocale::Zambia

260

 

QLocale::Zimbabwe

261

 
See Also

See also country(), countryToString()

enum QLocale::CurrencySymbolFormat

Specifies the format of the currency symbol.

Constant

Value

Description

QLocale::CurrencyIsoCode

0

a ISO-4217 code of the currency.

QLocale::CurrencySymbol

1

a currency symbol.

QLocale::CurrencyDisplayName

2

a user readable name of the currency.

[since 5.10] enum QLocale::DataSizeFormat

flags QLocale::DataSizeFormats

Specifies the format for representation of data quantities.

Constant

Value

Description

QLocale::DataSizeIecFormat

0

format using base 1024 and IEC prefixes: KiB, MiB, GiB, ...

QLocale::DataSizeTraditionalFormat

DataSizeSIQuantifiers

format using base 1024 and SI prefixes: kB, MB, GB, ...

QLocale::DataSizeSIFormat

DataSizeBase1000 | DataSizeSIQuantifiers

format using base 1000 and SI prefixes: kB, MB, GB, ...

This enum was introduced or modified in Qt 5.10.

The DataSizeFormats type is a typedef for QFlags<DataSizeFormat>. It stores an OR combination of DataSizeFormat values.

See Also

See also formattedDataSize()

[since 5.7] enum QLocale::FloatingPointPrecisionOption

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

Constant

Value

Description

QLocale::FloatingPointShortest

-128

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

This enum was introduced or modified in Qt 5.7.

See Also

See also toString(), QString, QByteArray

enum QLocale::FormatType

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

Constant

Value

Description

QLocale::LongFormat

0

Longer format.

QLocale::ShortFormat

1

Shorter format.

QLocale::NarrowFormat

2

A special version for use when space is very limited.

NarrowFormat might contain the same text for different months and days. It can even be an empty string if the locale doesn't support narrow names, so you should avoid using it for date formatting. Also, for the system locale this format is the same as ShortFormat.

See Also

enum QLocale::Language

This enumerated type is used to specify a language.

Constant

Value

QLocale::AnyLanguage

0

 

QLocale::C

1

A simplified English locale; see QLocale::c()

QLocale::Abkhazian

2

 

QLocale::Afan

Oromo

Obsolete, please use Oromo

QLocale::Afar

3

 

QLocale::Afrikaans

4

 

QLocale::Aghem

5

 

QLocale::Akan

6

 

QLocale::Akkadian

7

Since Qt 5.1

QLocale::Akoose

8

Since Qt 5.3

QLocale::Albanian

9

 

QLocale::AmericanSignLanguage

10

Since Qt 5.7

QLocale::Amharic

11

 

QLocale::AncientEgyptian

12

Since Qt 5.1

QLocale::AncientGreek

13

Since Qt 5.1

QLocale::Arabic

14

 

QLocale::Aragonese

15

Since Qt 5.1

QLocale::Aramaic

16

Since Qt 5.1

QLocale::Armenian

17

 

QLocale::Assamese

18

 

QLocale::Asturian

19

 

QLocale::Asu

20

 

QLocale::Atsam

21

 

QLocale::Avaric

22

 

QLocale::Avestan

23

 

QLocale::Aymara

24

 

QLocale::Azerbaijani

25

 

QLocale::Bafia

26

 

QLocale::Balinese

27

Since Qt 5.1

QLocale::Bambara

28

 

QLocale::Bamun

29

Since Qt 5.1

QLocale::Bangla

30

Since Qt 6.0

QLocale::Basaa

31

 

QLocale::Bashkir

32

 

QLocale::Basque

33

 

QLocale::BatakToba

34

Since Qt 5.1

QLocale::Belarusian

35

 

QLocale::Bemba

36

 

QLocale::Bena

37

 

QLocale::Bengali

Bangla

Obsolete, please use Bangla

QLocale::Bhojpuri

38

Since Qt 5.7

QLocale::Bhutani

Dzongkha

Obsolete, please use Dzongkha

QLocale::Bislama

39

 

QLocale::Blin

40

 

QLocale::Bodo

41

 

QLocale::Bosnian

42

 

QLocale::Breton

43

 

QLocale::Buginese

44

Since Qt 5.1

QLocale::Bulgarian

45

 

QLocale::Burmese

46

 

QLocale::Byelorussian

Belarusian

Obsolete, please use Belarusian

QLocale::Cambodian

Khmer

Obsolete, please use Khmer

QLocale::Cantonese

47

Since Qt 5.7

QLocale::Catalan

48

 

QLocale::Cebuano

49

Since Qt 5.14

QLocale::CentralAtlasTamazight

50

Since Qt 6.0

QLocale::CentralKurdish

51

Since Qt 5.5

QLocale::CentralMoroccoTamazight

CentralAtlasTamazight

Obsolete, please use CentralAtlasTamazight

QLocale::Chakma

52

Since Qt 5.1

QLocale::Chamorro

53

 

QLocale::Chechen

54

 

QLocale::Cherokee

55

 

QLocale::Chewa

Nyanja

Obsolete, please use Nyanja

QLocale::Chickasaw

56

Since Qt 5.14

QLocale::Chiga

57

 

QLocale::Chinese

58

(Mandarin)

QLocale::Church

59

 

QLocale::Chuvash

60

 

QLocale::Colognian

61

 

QLocale::Coptic

62

Since Qt 5.1

QLocale::Cornish

63

 

QLocale::Corsican

64

 

QLocale::Cree

65

 

QLocale::Croatian

66

 

QLocale::Czech

67

 

QLocale::Danish

68

 

QLocale::Divehi

69

 

QLocale::Dogri

70

Since Qt 5.1

QLocale::Duala

71

 

QLocale::Dutch

72

 

QLocale::Dzongkha

73

 

QLocale::Embu

74

 

QLocale::English

75

 

QLocale::Erzya

76

Since Qt 5.14

QLocale::Esperanto

77

 

QLocale::Estonian

78

 

QLocale::Ewe

79

 

QLocale::Ewondo

80

 

QLocale::Faroese

81

 

QLocale::Fijian

82

 

QLocale::Filipino

83

 

QLocale::Finnish

84

 

QLocale::French

85

 

QLocale::Frisian

WesternFrisian

same as WesternFrisian

QLocale::Friulian

86

 

QLocale::Fulah

87

 

QLocale::Ga

89

 

QLocale::Gaelic

88

 

QLocale::Galician

90

 

QLocale::Ganda

91

 

QLocale::Geez

92

 

QLocale::Georgian

93

 

QLocale::German

94

 

QLocale::Gothic

95

Since Qt 5.1

QLocale::Greek

96

 

QLocale::Greenlandic

Kalaallisut

Obsolete, please use Kalaallisut

QLocale::Guarani

97

 

QLocale::Gujarati

98

 

QLocale::Gusii

99

 

QLocale::Haitian

100

 

QLocale::Hausa

101

 

QLocale::Hawaiian

102

 

QLocale::Hebrew

103

 

QLocale::Herero

104

 

QLocale::Hindi

105

 

QLocale::HiriMotu

106

 

QLocale::Hungarian

107

 

QLocale::Icelandic

108

 

QLocale::Ido

109

Since Qt 5.12

QLocale::Igbo

110

 

QLocale::InariSami

111

Since Qt 5.5

QLocale::Indonesian

112

 

QLocale::Ingush

113

Since Qt 5.1

QLocale::Interlingua

114

 

QLocale::Interlingue

115

 

QLocale::Inuktitut

116

 

QLocale::Inupiak

Inupiaq

Obsolete, please use Inupiaq

QLocale::Inupiaq

117

Since 6.0

QLocale::Irish

118

 

QLocale::Italian

119

 

QLocale::Japanese

120

 

QLocale::Javanese

121

 

QLocale::Jju

122

 

QLocale::JolaFonyi

123

 

QLocale::Kabuverdianu

124

 

QLocale::Kabyle

125

 

QLocale::Kako

126

 

QLocale::Kalaallisut

127

Since Qt 6.0

QLocale::Kalenjin

128

 

QLocale::Kamba

129

 

QLocale::Kannada

130

 

QLocale::Kanuri

131

 

QLocale::Kashmiri

132

 

QLocale::Kazakh

133

 

QLocale::Kenyang

134

Since Qt 5.5

QLocale::Khmer

135

 

QLocale::Kiche

136

Since Qt 5.5

QLocale::Kikuyu

137

 

QLocale::Kinyarwanda

138

 

QLocale::Kirghiz

Kyrgyz

Obsolete, please use Kyrgyz

QLocale::Komi

139

 

QLocale::Kongo

140

 

QLocale::Konkani

141

 

QLocale::Korean

142

 

QLocale::Koro

143

 

QLocale::KoyraboroSenni

144

 

QLocale::KoyraChiini

145

 

QLocale::Kpelle

146

 

QLocale::Kuanyama

147

Since 6.0

QLocale::Kurdish

148

 

QLocale::Kurundi

Rundi

Obsolete, please use Rundi

QLocale::Kwanyama

Kuanyama

Obsolete, please use Kuanyama

QLocale::Kwasio

149

 

QLocale::Kyrgyz

150

Since 6.0

QLocale::Lakota

151

Since Qt 5.3

QLocale::Langi

152

 

QLocale::Lao

153

 

QLocale::Latin

154

 

QLocale::Latvian

155

 

QLocale::Lezghian

156

Since Qt 5.5

QLocale::Limburgish

157

 

QLocale::Lingala

158

 

QLocale::LiteraryChinese

159

Since Qt 5.7

QLocale::Lithuanian

160

 

QLocale::Lojban

161

Since Qt 5.12

QLocale::LowerSorbian

162

Since Qt 5.5

QLocale::LowGerman

163

 

QLocale::LubaKatanga

164

 

QLocale::LuleSami

165

Since Qt 5.5

QLocale::Luo

166

 

QLocale::Luxembourgish

167

 

QLocale::Luyia

168

 

QLocale::Macedonian

169

 

QLocale::Machame

170

 

QLocale::Maithili

171

Since Qt 5.5

QLocale::MakhuwaMeetto

172

 

QLocale::Makonde

173

 

QLocale::Malagasy

174

 

QLocale::Malay

176

 

QLocale::Malayalam

175

 

QLocale::Maltese

177

 

QLocale::Mandingo

178

Since Qt 5.1

QLocale::Manipuri

179

Since Qt 5.1

QLocale::Manx

180

 

QLocale::Maori

181

 

QLocale::Mapuche

182

Since Qt 5.5

QLocale::Marathi

183

 

QLocale::Marshallese

184

 

QLocale::Masai

185

 

QLocale::Mazanderani

186

Since Qt 5.7

QLocale::Mende

187

Since Qt 5.5

QLocale::Meru

188

 

QLocale::Meta

189

 

QLocale::Mohawk

190

Since Qt 5.5

QLocale::Mongolian

191

 

QLocale::Morisyen

192

 

QLocale::Mundang

193

 

QLocale::Muscogee

194

Since Qt 5.14

QLocale::Nama

195

 

QLocale::NauruLanguage

196

 

QLocale::Navaho

Navajo

Obsolete, please use Navajo

QLocale::Navajo

197

Since 6.0

QLocale::Ndonga

198

 

QLocale::Nepali

199

 

QLocale::Newari

200

Since Qt 5.7

QLocale::Ngiemboon

201

 

QLocale::NigerianPidgin

203

Since Qt 6.0

QLocale::Ngomba

202

 

QLocale::Nko

204

Since Qt 5.5

QLocale::NorthernLuri

205

Since Qt 5.7

QLocale::NorthernSami

206

 

QLocale::NorthernSotho

207

 

QLocale::NorthNdebele

208

 

QLocale::NorwegianBokmal

209

 

QLocale::NorwegianNynorsk

210

 

QLocale::Nuer

211

 

QLocale::Nyanja

212

 

QLocale::Nyankole

213

 

QLocale::Occitan

214

 

QLocale::Odia

215

Since 6.0

QLocale::Ojibwa

216

 

QLocale::OldIrish

217

Since Qt 5.1

QLocale::OldNorse

218

Since Qt 5.1

QLocale::OldPersian

219

Since Qt 5.1

QLocale::Oriya

Odia

Obsolete, please use Odia

QLocale::Oromo

220

 

QLocale::Osage

221

Since Qt 5.7

QLocale::Ossetic

222

 

QLocale::Pahlavi

223

Since Qt 5.1

QLocale::Palauan

224

Since Qt 5.7

QLocale::Pali

225

 

QLocale::Papiamento

226

Since Qt 5.7

QLocale::Pashto

227

 

QLocale::Persian

228

 

QLocale::Phoenician

229

Since Qt 5.1

QLocale::Polish

230

 

QLocale::Portuguese

231

 

QLocale::Prussian

232

Since Qt 5.5

QLocale::Punjabi

233

 

QLocale::Quechua

234

 

QLocale::RhaetoRomance

Romansh

Obsolete, please use Romansh

QLocale::Romanian

235

 

QLocale::Romansh

236

 

QLocale::Rombo

237

 

QLocale::Rundi

238

 

QLocale::Russian

239

 

QLocale::Rwa

240

 

QLocale::Saho

241

 

QLocale::Sakha

242

 

QLocale::Samburu

243

 

QLocale::Samoan

244

 

QLocale::Sango

245

 

QLocale::Sangu

246

 

QLocale::Sanskrit

247

 

QLocale::Santali

248

Since Qt 5.1

QLocale::Sardinian

249

 

QLocale::Saurashtra

250

Since Qt 5.1

QLocale::Sena

251

 

QLocale::Serbian

252

 

QLocale::Shambala

253

 

QLocale::Shona

254

 

QLocale::SichuanYi

255

 

QLocale::Sicilian

256

Since Qt 5.12

QLocale::Sidamo

257

 

QLocale::Silesian

258

Since Qt 5.14

QLocale::Sindhi

259

 

QLocale::Sinhala

260

 

QLocale::SkoltSami

261

Since Qt 5.5

QLocale::Slovak

262

 

QLocale::Slovenian

263

 

QLocale::Soga

264

 

QLocale::Somali

265

 

QLocale::SouthernKurdish

266

Since Qt 5.12

QLocale::SouthernSami

267

Since Qt 5.5

QLocale::SouthernSotho

268

 

QLocale::SouthNdebele

269

 

QLocale::Spanish

270

 

QLocale::StandardMoroccanTamazight

271

Since Qt 5.3

QLocale::Sundanese

272

 

QLocale::Swahili

273

 

QLocale::Swati

274

 

QLocale::Swedish

275

 

QLocale::SwissGerman

276

 

QLocale::Syriac

277

 

QLocale::Tachelhit

278

 

QLocale::Tahitian

279

 

QLocale::TaiDam

280

Since Qt 5.1

QLocale::Taita

281

 

QLocale::Tajik

282

 

QLocale::Tamil

283

 

QLocale::Taroko

284

 

QLocale::Tasawaq

285

 

QLocale::Tatar

286

 

QLocale::Telugu

287

 

QLocale::Teso

288

 

QLocale::Thai

289

 

QLocale::Tibetan

290

 

QLocale::Tigre

291

 

QLocale::Tigrinya

292

 

QLocale::TokelauLanguage

293

Since Qt 5.7

QLocale::TokPisin

294

Since Qt 5.7

QLocale::Tongan

295

 

QLocale::Tsonga

296

 

QLocale::Tswana

297

 

QLocale::Turkish

298

 

QLocale::Turkmen

299

 

QLocale::TuvaluLanguage

300

Since Qt 5.7

QLocale::Tyap

301

 

QLocale::Ugaritic

302

Since Qt 5.1

QLocale::Uighur

Uyghur

Obsolete, please use Uyghur

QLocale::Uigur

Uyghur

Obsolete, please use Uyghur

QLocale::Ukrainian

303

 

QLocale::UpperSorbian

304

Since Qt 5.5

QLocale::Urdu

305

 

QLocale::Uyghur

306

Since 6.0

QLocale::Uzbek

307

 

QLocale::Vai

308

 

QLocale::Venda

309

 

QLocale::Vietnamese

310

 

QLocale::Volapuk

311

 

QLocale::Vunjo

312

 

QLocale::Walamo

Wolaytta

Obsolete, please use Wolaytta

QLocale::Walloon

313

 

QLocale::Walser

314

 

QLocale::Warlpiri

315

Since Qt 5.5

QLocale::Welsh

316

 

QLocale::WesternBalochi

317

Since Qt 5.12

QLocale::WesternFrisian

318

same as Frisian

QLocale::Wolaytta

319

Since 6.0

QLocale::Wolof

320

 

QLocale::Xhosa

321

 

QLocale::Yangben

322

 

QLocale::Yiddish

323

 

QLocale::Yoruba

324

 

QLocale::Zarma

325

 

QLocale::Zhuang

326

 

QLocale::Zulu

327

 
See Also

See also language(), languageToString()

enum QLocale::MeasurementSystem

This enum defines which units are used for measurement.

Constant

Value

Description

QLocale::MetricSystem

0

This value indicates metric units, such as meters, centimeters and millimeters.

QLocale::ImperialUSSystem

1

This value indicates imperial units, such as inches and miles as they are used in the United States.

QLocale::ImperialUKSystem

2

This value indicates imperial units, such as inches and miles as they are used in the United Kingdom.

QLocale::ImperialSystem

ImperialUSSystem

Provided for compatibility. Same as ImperialUSSystem

enum QLocale::NumberOption

flags QLocale::NumberOptions

This enum defines a set of options for number-to-string and string-to-number conversions. They can be retrieved with numberOptions() and set with setNumberOptions().

Constant

Value

Description

QLocale::DefaultNumberOptions

0x0

This option represents the default behavior, with group separators, with one leading zero in single digit exponents, and without trailing zeroes after the decimal dot.

QLocale::OmitGroupSeparator

0x01

If this option is set, the number-to-string functions will not insert group separators in their return values. The default is to insert group separators.

QLocale::RejectGroupSeparator

0x02

If this option is set, the string-to-number functions will fail if they encounter group separators in their input. The default is to accept numbers containing correctly placed group separators.

QLocale::OmitLeadingZeroInExponent

0x04

If this option is set, the number-to-string functions will not pad exponents with zeroes when printing floating point numbers in scientific notation. The default is to add one leading zero to single digit exponents.

QLocale::RejectLeadingZeroInExponent

0x08

If this option is set, the string-to-number functions will fail if they encounter an exponent padded with zeroes when parsing a floating point number in scientific notation. The default is to accept such padding.

QLocale::IncludeTrailingZeroesAfterDot

0x10

If this option is set, the number-to-string functions will pad numbers with zeroes to the requested precision in "g" or "most concise" mode, even if the number of significant digits is lower than the requested precision. The default is to omit trailing zeroes.

QLocale::RejectTrailingZeroesAfterDot

0x20

If this option is set, the string-to-number functions will fail if they encounter trailing zeroes after the decimal dot when parsing a number in scientific or decimal representation. The default is to accept trailing zeroes.

The NumberOptions type is a typedef for QFlags<NumberOption>. It stores an OR combination of NumberOption values.

See Also

enum QLocale::QuotationStyle

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

Constant

Value

Description

QLocale::StandardQuotation

0

If this option is set, the standard quotation marks will be used to quote strings.

QLocale::AlternateQuotation

1

If this option is set, the alternate quotation marks will be used to quote strings.

See Also

See also quoteString()

enum QLocale::Script

This enumerated type is used to specify a script.

Constant

Value

QLocale::AnyScript

0

 

QLocale::AdlamScript

1

Since Qt 5.7

QLocale::AhomScript

2

Since Qt 5.7

QLocale::AnatolianHieroglyphsScript

3

Since Qt 5.7

QLocale::ArabicScript

4

 

QLocale::ArmenianScript

5

 

QLocale::AvestanScript

6

Since Qt 5.1

QLocale::BalineseScript

7

Since Qt 5.1

QLocale::BamumScript

8

Since Qt 5.1

QLocale::BanglaScript

9

Since 6.0

QLocale::BassaVahScript

10

Since Qt 5.5

QLocale::BatakScript

11

Since Qt 5.1

QLocale::BengaliScript

BanglaScript

Obsolete, please use BanglaScript

QLocale::BhaiksukiScript

12

Since Qt 5.7

QLocale::BopomofoScript

13

Since Qt 5.1

QLocale::BrahmiScript

14

Since Qt 5.1

QLocale::BrailleScript

15

Since Qt 5.1

QLocale::BugineseScript

16

Since Qt 5.1

QLocale::BuhidScript

17

Since Qt 5.1

QLocale::CanadianAboriginalScript

18

Since Qt 5.1

QLocale::CarianScript

19

Since Qt 5.1

QLocale::CaucasianAlbanianScript

20

Since Qt 5.5

QLocale::ChakmaScript

21

Since Qt 5.1

QLocale::ChamScript

22

Since Qt 5.1

QLocale::CherokeeScript

23

 

QLocale::CopticScript

24

Since Qt 5.1

QLocale::CuneiformScript

25

Since Qt 5.1

QLocale::CypriotScript

26

Since Qt 5.1

QLocale::CyrillicScript

27

 

QLocale::DeseretScript

28

Since Qt 5.1

QLocale::DevanagariScript

29

 

QLocale::DuployanScript

30

Since Qt 5.5

QLocale::EgyptianHieroglyphsScript

31

Since Qt 5.1

QLocale::ElbasanScript

32

Since Qt 5.5

QLocale::EthiopicScript

33

 

QLocale::FraserScript

34

Since Qt 5.1

QLocale::GeorgianScript

35

 

QLocale::GlagoliticScript

36

Since Qt 5.1

QLocale::GothicScript

37

Since Qt 5.1

QLocale::GranthaScript

38

Since Qt 5.5

QLocale::GreekScript

39

 

QLocale::GujaratiScript

40

 

QLocale::GurmukhiScript

41

 

QLocale::HangulScript

42

Since Qt 5.1

QLocale::HanScript

43

Since Qt 5.1

QLocale::HanunooScript

44

Since Qt 5.1

QLocale::HanWithBopomofoScript

45

Since Qt 5.7

QLocale::HatranScript

46

Since Qt 5.7

QLocale::HebrewScript

47

 

QLocale::HiraganaScript

48

Since Qt 5.1

QLocale::ImperialAramaicScript

49

Since Qt 5.1

QLocale::InscriptionalPahlaviScript

50

Since Qt 5.1

QLocale::InscriptionalParthianScript

51

Since Qt 5.1

QLocale::JamoScript

52

Since Qt 5.7

QLocale::JapaneseScript

53

 

QLocale::JavaneseScript

54

Since Qt 5.1

QLocale::KaithiScript

55

Since Qt 5.1

QLocale::KannadaScript

56

 

QLocale::KatakanaScript

57

Since Qt 5.1

QLocale::KayahLiScript

58

Since Qt 5.1

QLocale::KharoshthiScript

59

Since Qt 5.1

QLocale::KhmerScript

60

Since Qt 5.1

QLocale::KhojkiScript

61

Since Qt 5.5

QLocale::KhudawadiScript

62

Since Qt 5.5

QLocale::KoreanScript

63

 

QLocale::LannaScript

64

Since Qt 5.1

QLocale::LaoScript

65

 

QLocale::LatinScript

66

 

QLocale::LepchaScript

67

Since Qt 5.1

QLocale::LimbuScript

68

Since Qt 5.1

QLocale::LinearAScript

69

Since Qt 5.5

QLocale::LinearBScript

70

Since Qt 5.1

QLocale::LycianScript

71

Since Qt 5.1

QLocale::LydianScript

72

Since Qt 5.1

QLocale::MahajaniScript

73

Since Qt 5.5

QLocale::MalayalamScript

74

 

QLocale::MandaeanScript

75

Since Qt 5.1

QLocale::ManichaeanScript

76

Since Qt 5.5

QLocale::MarchenScript

77

Since Qt 5.7

QLocale::MeiteiMayekScript

78

Since Qt 5.1

QLocale::MendeScript

79

Since Qt 6.0

QLocale::MendeKikakuiScript

MendeScript

Obsolete, please use MendeScript

QLocale::MeroiticCursiveScript

80

Since Qt 5.1

QLocale::MeroiticScript

81

Since Qt 5.1

QLocale::ModiScript

82

Since Qt 5.5

QLocale::MongolianScript

83

 

QLocale::MroScript

84

Since Qt 5.5

QLocale::MultaniScript

85

Since Qt 5.7

QLocale::MyanmarScript

86

 

QLocale::NabataeanScript

87

Since Qt 5.5

QLocale::NewaScript

88

Since Qt 5.7

QLocale::NewTaiLueScript

89

Since Qt 5.1

QLocale::NkoScript

90

Since Qt 5.1

QLocale::OghamScript

92

Since Qt 5.1

QLocale::OlChikiScript

93

Since Qt 5.1

QLocale::OldHungarianScript

94

Since Qt 5.7

QLocale::OldItalicScript

95

Since Qt 5.1

QLocale::OldNorthArabianScript

96

Since Qt 5.5

QLocale::OldPermicScript

97

Since Qt 5.5

QLocale::OldPersianScript

98

Since Qt 5.1

QLocale::OldSouthArabianScript

99

Since Qt 5.1

QLocale::OdiaScript

91

Since 6.0

QLocale::OriyaScript

OdiaScript

Obsolete, please use OdiaScript

QLocale::OrkhonScript

100

Since Qt 5.1

QLocale::OsageScript

101

Since Qt 5.7

QLocale::OsmanyaScript

102

Since Qt 5.1

QLocale::PahawhHmongScript

103

Since Qt 5.5

QLocale::PalmyreneScript

104

Since Qt 5.5

QLocale::PauCinHauScript

105

Since Qt 5.5

QLocale::PhagsPaScript

106

Since Qt 5.1

QLocale::PhoenicianScript

107

Since Qt 5.1

QLocale::PollardPhoneticScript

108

Since Qt 5.1

QLocale::PsalterPahlaviScript

109

Since Qt 5.5

QLocale::RejangScript

110

Since Qt 5.1

QLocale::RunicScript

111

Since Qt 5.1

QLocale::SamaritanScript

112

Since Qt 5.1

QLocale::SaurashtraScript

113

Since Qt 5.1

QLocale::SharadaScript

114

Since Qt 5.1

QLocale::ShavianScript

115

Since Qt 5.1

QLocale::SiddhamScript

116

Since Qt 5.5

QLocale::SignWritingScript

117

Since Qt 5.7

QLocale::SimplifiedChineseScript

SimplifiedHanScript

same as SimplifiedHanScript

QLocale::SimplifiedHanScript

118

same as SimplifiedChineseScript

QLocale::SinhalaScript

119

 

QLocale::SoraSompengScript

120

Since Qt 5.1

QLocale::SundaneseScript

121

Since Qt 5.1

QLocale::SylotiNagriScript

122

Since Qt 5.1

QLocale::SyriacScript

123

 

QLocale::TagalogScript

124

Since Qt 5.1

QLocale::TagbanwaScript

125

Since Qt 5.1

QLocale::TaiLeScript

126

Since Qt 5.1

QLocale::TaiVietScript

127

Since Qt 5.1

QLocale::TakriScript

128

Since Qt 5.1

QLocale::TamilScript

129

 

QLocale::TangutScript

130

Since Qt 5.7

QLocale::TeluguScript

131

 

QLocale::ThaanaScript

132

 

QLocale::ThaiScript

133

 

QLocale::TibetanScript

134

 

QLocale::TifinaghScript

135

 

QLocale::TirhutaScript

136

Since Qt 5.5

QLocale::TraditionalChineseScript

TraditionalHanScript

same as TraditionalHanScript

QLocale::TraditionalHanScript

137

same as TraditionalChineseScript

QLocale::UgariticScript

138

Since Qt 5.1

QLocale::VaiScript

139

 

QLocale::VarangKshitiScript

140

Since Qt 5.5

QLocale::YiScript

141

 
See Also

Member Function Documentation

 

QLocale::QLocale()

Constructs a QLocale object initialized with the default locale. If no default locale was set using setDefault(), this locale will be the same as the one returned by system().

See Also

See also setDefault()

[explicit] QLocale::QLocale(const QString &name)

Constructs a QLocale object with the specified name, which has the format "language[_script][_country][.codeset][@modifier]" or "C", where:

  • language is a lowercase, two-letter, ISO 639 language code (also some three-letter codes),

  • script is a titlecase, four-letter, ISO 15924 script code,

  • country is an uppercase, two-letter, ISO 3166 country code (also "419" as defined by United Nations),

  • and codeset and modifier are ignored.

The separator can be either underscore '_' (U+005F, "low line") or a dash '-' (U+002D, "hyphen-minus").

If the string violates the locale format, or language is not a valid ISO 639 code, the "C" locale is used instead. If country is not present, or is not a valid ISO 3166 code, the most appropriate country is chosen for the specified language.

The language, script and country codes are converted to their respective Language, Script and Country enums. After this conversion is performed, the constructor behaves exactly like QLocale(Country, Script, Language).

This constructor is much slower than QLocale(Country, Script, Language).

See Also

See also bcp47Name()

QLocale::QLocale(QLocale::Language language, QLocale::Country country = AnyCountry)

Constructs a QLocale object with the specified language and country.

  • If the language/country pair is found in the database, it is used.

  • If the language is found but the country is not, or if the country is AnyCountry, the language is used with the most appropriate available country (for example, Germany for German),

  • If neither the language nor the country are found, QLocale defaults to the default locale (see setDefault()).

The language and country that are actually used can be queried using language() and country().

See Also

See also setDefault(), language(), country()

QLocale::QLocale(QLocale::Language language, QLocale::Script script, QLocale::Country country)

Constructs a QLocale object with the specified language, script and country.

  • If the language/script/country is found in the database, it is used.

  • If both script is AnyScript and country is AnyCountry, the language is used with the most appropriate available script and country (for example, Germany for German),

  • If either script is AnyScript or country is AnyCountry, the language is used with the first locale that matches the given script and country.

  • If neither the language nor the country are found, QLocale defaults to the default locale (see setDefault()).

The language, script and country that are actually used can be queried using language(), script() and country().

See Also

See also setDefault(), language(), script(), country()

QLocale::QLocale(const QLocale &other)

Constructs a QLocale object as a copy of other.

QLocale::~QLocale()

Destructor

QString QLocale::amText() const

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

See Also

See also pmText()

QString QLocale::bcp47Name() const

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

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

This function tries to conform the locale name to BCP47.

See Also

See also language(), country(), script(), uiLanguages()

[static] QLocale QLocale::c()

Returns a QLocale object initialized to the "C" locale.

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

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

See Also

See also system()

[since 5.13] QLocale QLocale::collation() const

Returns the locale to use for collation.

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

This function was introduced in Qt 5.13.

See Also

See also QCollator

QLocale::Country QLocale::country() const

Returns the country of this locale.

See Also

[static] QString QLocale::countryToString(QLocale::Country country)

Returns a QString containing the name of country.

See Also

QString QLocale::createSeparatedList(const QStringList &list) const

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

QString QLocale::currencySymbol(QLocale::CurrencySymbolFormat format = CurrencySymbol) const

Returns a currency symbol according to the format.

QString QLocale::dateFormat(QLocale::FormatType format = LongFormat) const

Returns the date format used for the current locale.

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

See Also

QString QLocale::dateTimeFormat(QLocale::FormatType format = LongFormat) const

Returns the date time format used for the current locale.

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

See Also

QString QLocale::dayName(int day, QLocale::FormatType type = LongFormat) const

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

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

See Also

QString QLocale::decimalPoint() const

Returns the decimal point character of this locale.

See Also

See also groupSeparator(), toString()

QString QLocale::exponential() const

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

See Also

See also toString(double, char, int)

Qt::DayOfWeek QLocale::firstDayOfWeek() const

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

[since 5.10] QString QLocale::formattedDataSize(qint64 bytes, int precision = 2, QLocale::DataSizeFormats format = DataSizeIecFormat) const

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

This function was introduced in Qt 5.10.

QString QLocale::groupSeparator() const

Returns the group separator character of this locale.

See Also

See also decimalPoint(), toString()

QLocale::Language QLocale::language() const

Returns the language of this locale.

See Also

[static] QString QLocale::languageToString(QLocale::Language language)

Returns a QString containing the name of language.

See Also

[static] QList<QLocale> QLocale::matchingLocales(QLocale::Language language, QLocale::Script script, QLocale::Country country)

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

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

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

QLocale::MeasurementSystem QLocale::measurementSystem() const

Returns the measurement system for the locale.

QString QLocale::monthName(int month, QLocale::FormatType type = LongFormat) const

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

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

See Also

QString QLocale::name() const

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

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

See Also

See also QLocale(), language(), script(), country(), bcp47Name()

QString QLocale::nativeCountryName() const

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

See Also

QString QLocale::nativeLanguageName() const

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

See Also

QString QLocale::negativeSign() const

Returns the negative sign character of this locale.

See Also

See also positiveSign(), toString()

QLocale::NumberOptions QLocale::numberOptions() const

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

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

See Also

QString QLocale::percent() const

Returns the percent character of this locale.

See Also

See also toString()

QString QLocale::pmText() const

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

See Also

See also amText()

QString QLocale::positiveSign() const

Returns the positive sign character of this locale.

See Also

See also negativeSign(), toString()

QString QLocale::quoteString(const QString &str, QLocale::QuotationStyle style = StandardQuotation) const

Returns str quoted according to the current locale using the given quotation style.

[since 6.0] QString QLocale::quoteString(QStringView str, QLocale::QuotationStyle style = StandardQuotation) const

This is an overloaded function.

This function was introduced in Qt 6.0.

QLocale::Script QLocale::script() const

Returns the script of this locale.

See Also

[static] QString QLocale::scriptToString(QLocale::Script script)

Returns a QString containing the name of script.

See Also

[static] void QLocale::setDefault(const QLocale &locale)

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

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

This function is not reentrant.

See Also

See also system(), c()

void QLocale::setNumberOptions(QLocale::NumberOptions options)

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

See Also

See also numberOptions()

QString QLocale::standaloneDayName(int day, QLocale::FormatType type = LongFormat) const

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

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

See Also

QString QLocale::standaloneMonthName(int month, QLocale::FormatType type = LongFormat) const

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

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

See Also

[since 5.6] void QLocale::swap(QLocale &other)

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

This function was introduced in Qt 5.6.

[static] QLocale QLocale::system()

Returns a QLocale object initialized to the system locale.

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

See Also

See also c()

Qt::LayoutDirection QLocale::textDirection() const

Returns the text direction of the language.

QString QLocale::timeFormat(QLocale::FormatType format = LongFormat) const

Returns the time format used for the current locale.

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

See Also

QString QLocale::toCurrencyString(qlonglong value, const QString &symbol = QString()) const

Returns a localized string representation of value as a currency. If the symbol is provided it is used instead of the default currency symbol.

See Also

See also currencySymbol()

QString QLocale::toCurrencyString(qulonglong value, const QString &symbol = QString()) const

This is an overloaded function.

QString QLocale::toCurrencyString(short value, const QString &symbol = QString()) const

This is an overloaded function.

QString QLocale::toCurrencyString(ushort value, const QString &symbol = QString()) const

This is an overloaded function.

QString QLocale::toCurrencyString(int value, const QString &symbol = QString()) const

This is an overloaded function.

QString QLocale::toCurrencyString(uint value, const QString &symbol = QString()) const

This is an overloaded function.

[since 5.7] QString QLocale::toCurrencyString(double value, const QString &symbol = QString(), int precision = -1) const

This function overloads toCurrencyString().

Returns a localized string representation of value as a currency. If the symbol is provided it is used instead of the default currency symbol. If the precision is provided it is used to set the precision of the currency value.

This function was introduced in Qt 5.7.

See Also

See also currencySymbol()

QString QLocale::toCurrencyString(float i, const QString &symbol = QString(), int precision = -1) const

This function overloads toCurrencyString().

QDate QLocale::toDate(const QString &string, QLocale::FormatType format = LongFormat) const

Parses the date string given in string and returns the date. The format of the date string is chosen according to the format parameter (see dateFormat()).

If the date could not be parsed, returns an invalid date.

See Also

QDate QLocale::toDate(const QString &string, const QString &format) const

Parses the date string given in string and returns the date. See QDate::fromString() for information on the expressions that can be used with this function.

This function searches month names and the names of the days of the week in the current locale.

If the date could not be parsed, returns an invalid date.

See Also

[since 5.14] QDate QLocale::toDate(const QString &string, QLocale::FormatType format, QCalendar cal) const

This is an overloaded function.

This function was introduced in Qt 5.14.

[since 5.14] QDate QLocale::toDate(const QString &string, const QString &format, QCalendar cal) const

This is an overloaded function.

This function was introduced in Qt 5.14.

QDateTime QLocale::toDateTime(const QString &string, QLocale::FormatType format = LongFormat) const

Parses the date/time string given in string and returns the time. The format of the date/time string is chosen according to the format parameter (see dateTimeFormat()).

If the string could not be parsed, returns an invalid QDateTime.

See Also

QDateTime QLocale::toDateTime(const QString &string, const QString &format) const

Parses the date/time string given in string and returns the time. See QDateTime::fromString() for information on the expressions that can be used with this function.

The month and day names used must be given in the user's local language.

If the string could not be parsed, returns an invalid QDateTime. If the string can be parsed and represents an invalid date-time (e.g. in a gap skipped by a time-zone transition), an invalid QDateTime is returned, whose toMSecsSinceEpoch() represents a near-by date-time that is valid. Passing that to fromMSecsSinceEpoch() will produce a valid date-time that isn't faithfully represented by the string parsed.

See Also

[since 5.14] QDateTime QLocale::toDateTime(const QString &string, QLocale::FormatType format, QCalendar cal) const

This is an overloaded function.

This function was introduced in Qt 5.14.

[since 5.14] QDateTime QLocale::toDateTime(const QString &string, const QString &format, QCalendar cal) const

This is an overloaded function.

This function was introduced in Qt 5.14.

double QLocale::toDouble(const QString &s, bool *ok = nullptr) const

Returns the double represented by the localized string s.

Returns an infinity if the conversion overflows or 0.0 if the conversion fails for any other reason (e.g. underflow).

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

This function does not fall back to the 'C' locale if the string cannot be interpreted in this locale.

 
Sélectionnez
bool ok;
double d;

QLocale c(QLocale::C);
d = c.toDouble("1234.56", &amp;ok);  // ok == true,  d == 1234.56
d = c.toDouble("1,234.56", &amp;ok); // ok == true,  d == 1234.56
d = c.toDouble("1234,56", &amp;ok);  // ok == false, d == 0

QLocale german(QLocale::German);
d = german.toDouble("1234,56", &amp;ok);  // ok == true,  d == 1234.56
d = german.toDouble("1.234,56", &amp;ok); // ok == true,  d == 1234.56
d = german.toDouble("1234.56", &amp;ok);  // ok == false, d == 0

d = german.toDouble("1.234", &amp;ok);    // ok == true,  d == 1234.0

Notice that the last conversion returns 1234.0, because '.' is the thousands group separator in the German locale.

This function ignores leading and trailing whitespace.

See Also

See also toFloat(), toInt(), toString()

[since 5.10] double QLocale::toDouble(QStringView s, bool *ok = nullptr) const

Returns the double represented by the localized string s.

Returns an infinity if the conversion overflows or 0.0 if the conversion fails for any other reason (e.g. underflow).

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

Unlike QString::toDouble(), this function does not fall back to the "C" locale if the string cannot be interpreted in this locale.

 
Sélectionnez
bool ok;
double d;

QLocale c(QLocale::C);
d = c.toDouble(u"1234.56", &amp;ok);  // ok == true,  d == 1234.56
d = c.toDouble(u"1,234.56", &amp;ok); // ok == true,  d == 1234.56
d = c.toDouble(u"1234,56", &amp;ok);  // ok == false, d == 0

QLocale german(QLocale::German);
d = german.toDouble(u"1234,56", &amp;ok);  // ok == true,  d == 1234.56
d = german.toDouble(u"1.234,56", &amp;ok); // ok == true,  d == 1234.56
d = german.toDouble(u"1234.56", &amp;ok);  // ok == false, d == 0

d = german.toDouble(u"1.234", &amp;ok);    // ok == true,  d == 1234.0

Notice that the last conversion returns 1234.0, because '.' is the thousands group separator in the German locale.

This function ignores leading and trailing whitespace.

This function was introduced in Qt 5.10.

See Also

See also toFloat(), toInt(), toString()

float QLocale::toFloat(const QString &s, bool *ok = nullptr) const

Returns the float represented by the localized string s.

Returns an infinity if the conversion overflows or 0.0 if the conversion fails for any other reason (e.g. underflow).

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

This function does not fall back to the 'C' locale if the string cannot be interpreted in this locale.

This function ignores leading and trailing whitespace.

See Also

See also toDouble(), toInt(), toString()

[since 5.10] float QLocale::toFloat(QStringView s, bool *ok = nullptr) const

Returns the float represented by the localized string s.

Returns an infinity if the conversion overflows or 0.0 if the conversion fails for any other reason (e.g. underflow).

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

This function ignores leading and trailing whitespace.

This function was introduced in Qt 5.10.

See Also

See also toDouble(), toInt(), toString()

int QLocale::toInt(const QString &s, bool *ok = nullptr) const

Returns the int represented by the localized string s.

If the conversion fails the function returns 0.

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

This function ignores leading and trailing whitespace.

See Also

See also toUInt(), toString()

[since 5.10] int QLocale::toInt(QStringView s, bool *ok = nullptr) const

Returns the int represented by the localized string s.

If the conversion fails, the function returns 0.

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

This function ignores leading and trailing whitespace.

This function was introduced in Qt 5.10.

See Also

See also toUInt(), toString()

[since 5.13] long QLocale::toLong(const QString &s, bool *ok = nullptr) const

Returns the long int represented by the localized string s.

If the conversion fails the function returns 0.

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

This function ignores leading and trailing whitespace.

This function was introduced in Qt 5.13.

See Also

See also toInt(), toULong(), toDouble(), toString()

[since 5.13] long QLocale::toLong(QStringView s, bool *ok = nullptr) const

Returns the long int represented by the localized string s.

If the conversion fails the function returns 0.

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

This function ignores leading and trailing whitespace.

This function was introduced in Qt 5.13.

See Also

See also toInt(), toULong(), toDouble(), toString()

qlonglong QLocale::toLongLong(const QString &s, bool *ok = nullptr) const

Returns the long long int represented by the localized string s.

If the conversion fails the function returns 0.

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

This function ignores leading and trailing whitespace.

See Also

See also toInt(), toULongLong(), toDouble(), toString()

[since 5.10] qlonglong QLocale::toLongLong(QStringView s, bool *ok = nullptr) const

Returns the long long int represented by the localized string s.

If the conversion fails, the function returns 0.

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

This function ignores leading and trailing whitespace.

This function was introduced in Qt 5.10.

See Also

See also toInt(), toULongLong(), toDouble(), toString()

QString QLocale::toLower(const QString &str) const

Returns a lowercase copy of str.

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

See Also

See also QString::toLower()

short QLocale::toShort(const QString &s, bool *ok = nullptr) const

Returns the short int represented by the localized string s.

If the conversion fails the function returns 0.

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

This function ignores leading and trailing whitespace.

See Also

See also toUShort(), toString()

[since 5.10] short QLocale::toShort(QStringView s, bool *ok = nullptr) const

Returns the short int represented by the localized string s.

If the conversion fails, the function returns 0.

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

This function ignores leading and trailing whitespace.

This function was introduced in Qt 5.10.

See Also

See also toUShort(), toString()

QString QLocale::toString(qlonglong i) const

Returns a localized string representation of i.

See Also

QString QLocale::toString(qulonglong i) const

This is an overloaded function.

See Also

QString QLocale::toString(long i) const

This is an overloaded function.

See Also

See also toLong()

QString QLocale::toString(ulong i) const

This is an overloaded function.

See Also

See also toULong()

QString QLocale::toString(short i) const

This is an overloaded function.

See Also

See also toShort()

QString QLocale::toString(ushort i) const

This is an overloaded function.

See Also

See also toUShort()

QString QLocale::toString(int i) const

This is an overloaded function.

See Also

See also toInt()

QString QLocale::toString(uint i) const

This is an overloaded function.

See Also

See also toUInt()

QString QLocale::toString(double i, char f = 'g', int prec = 6) const

This is an overloaded function.

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

See Also

QString QLocale::toString(float i, char f = 'g', int prec = 6) const

This is an overloaded function.

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

See Also

See also toDouble()

QString QLocale::toString(QDate date, const QString &format) const

Returns a localized string representation of the given date in the specified format. If format is an empty string, an empty string is returned.

See Also

See also QDate::toString()

QString QLocale::toString(QTime time, const QString &format) const

Returns a localized string representation of the given time according to the specified format. If format is an empty string, an empty string is returned.

See Also

See also QTime::toString()

QString QLocale::toString(const QDateTime &dateTime, const QString &format) const

Returns a localized string representation of the given dateTime according to the specified format. If format is an empty string, an empty string is returned.

See Also

[since 5.10] QString QLocale::toString(QDate date, QStringView format) const

Returns a localized string representation of the given date in the specified format. If format is an empty string, an empty string is returned.

This function was introduced in Qt 5.10.

See Also

See also QDate::toString()

[since 5.10] QString QLocale::toString(QTime time, QStringView format) const

Returns a localized string representation of the given time according to the specified format. If format is an empty string, an empty string is returned.

This function was introduced in Qt 5.10.

See Also

See also QTime::toString()

[since 5.10] QString QLocale::toString(const QDateTime &dateTime, QStringView format) const

Returns a localized string representation of the given dateTime according to the specified format. If format is an empty string, an empty string is returned.

This function was introduced in Qt 5.10.

See Also

QString QLocale::toString(QDate date, QLocale::FormatType format = LongFormat) const

Returns a localized string representation of the given date according to the specified format (see dateFormat()).

Some locales may use formats that limit the range of years they can represent.

QString QLocale::toString(QTime time, QLocale::FormatType format = LongFormat) const

Returns a localized string representation of the given time in the specified format (see timeFormat()).

QString QLocale::toString(const QDateTime &dateTime, QLocale::FormatType format = LongFormat) const

Returns a localized string representation of the given dateTime according to the specified format (see dateTimeFormat()).

Some locales may use formats that limit the range of years they can represent.

QTime QLocale::toTime(const QString &string, QLocale::FormatType format = LongFormat) const

Parses the time string given in string and returns the time. The format of the time string is chosen according to the format parameter (see timeFormat()).

If the time could not be parsed, returns an invalid time.

See Also

QTime QLocale::toTime(const QString &string, const QString &format) const

Parses the time string given in string and returns the time. See QTime::fromString() for information on what is a valid format string.

If the time could not be parsed, returns an invalid time.

See Also

uint QLocale::toUInt(const QString &s, bool *ok = nullptr) const

Returns the unsigned int represented by the localized string s.

If the conversion fails the function returns 0.

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

This function ignores leading and trailing whitespace.

See Also

See also toInt(), toString()

[since 5.10] uint QLocale::toUInt(QStringView s, bool *ok = nullptr) const

Returns the unsigned int represented by the localized string s.

If the conversion fails, the function returns 0.

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

This function ignores leading and trailing whitespace.

This function was introduced in Qt 5.10.

See Also

See also toInt(), toString()

[since 5.13] ulong QLocale::toULong(const QString &s, bool *ok = nullptr) const

Returns the unsigned long int represented by the localized string s.

If the conversion fails the function returns 0.

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

This function ignores leading and trailing whitespace.

This function was introduced in Qt 5.13.

See Also

See also toLong(), toInt(), toDouble(), toString()

[since 5.13] ulong QLocale::toULong(QStringView s, bool *ok = nullptr) const

Returns the unsigned long int represented by the localized string s.

If the conversion fails the function returns 0.

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

This function ignores leading and trailing whitespace.

This function was introduced in Qt 5.13.

See Also

See also toLong(), toInt(), toDouble(), toString()

qulonglong QLocale::toULongLong(const QString &s, bool *ok = nullptr) const

Returns the unsigned long long int represented by the localized string s.

If the conversion fails the function returns 0.

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

This function ignores leading and trailing whitespace.

See Also

See also toLongLong(), toInt(), toDouble(), toString()

[since 5.10] qulonglong QLocale::toULongLong(QStringView s, bool *ok = nullptr) const

Returns the unsigned long long int represented by the localized string s.

If the conversion fails, the function returns 0.

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

This function ignores leading and trailing whitespace.

This function was introduced in Qt 5.10.

See Also

See also toLongLong(), toInt(), toDouble(), toString()

ushort QLocale::toUShort(const QString &s, bool *ok = nullptr) const

Returns the unsigned short int represented by the localized string s.

If the conversion fails the function returns 0.

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

This function ignores leading and trailing whitespace.

See Also

See also toShort(), toString()

[since 5.10] ushort QLocale::toUShort(QStringView s, bool *ok = nullptr) const

Returns the unsigned short int represented by the localized string s.

If the conversion fails, the function returns 0.

If ok is not nullptr, failure is reported by setting *ok to false, and success by setting *ok to true.

This function ignores leading and trailing whitespace.

This function was introduced in Qt 5.10.

See Also

See also toShort(), toString()

QString QLocale::toUpper(const QString &str) const

Returns an uppercase copy of str.

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

See Also

See also QString::toUpper()

QStringList QLocale::uiLanguages() const

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

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

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

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

See Also

See also QTranslator, bcp47Name()

QList<Qt::DayOfWeek> QLocale::weekdays() const

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

QString QLocale::zeroDigit() const

Returns the zero digit character of this locale.

See Also

See also toString()

QLocale &QLocale::operator=(const QLocale &other)

Assigns other to this QLocale object and returns a reference to this QLocale object.

Related Non-Members

 

[since 5.6] size_t qHash(const QLocale &key, size_t seed = 0)

Returns the hash value for key, using seed to seed the calculation.

This function was introduced in Qt 5.6.

bool operator!=(const QLocale &lhs, const QLocale &rhs)

Returns true if the two QLocale objects, lhs and rhs, differ; otherwise returns false.

The system locale is not equal to the QLocale object constructed from its language(), script() and country(), even if the two agree in all data fields. Nor are two locales with different number options equal.

See Also

bool operator==(const QLocale &lhs, const QLocale &rhs)

Returns true if the two QLocale objects, lhs and rhs, are the same; otherwise returns false.

The system locale is not equal to the QLocale object constructed from its language(), script() and country(), even if the two agree in all data fields. Nor are two locales with different number options equal.

See Also

Obsolete Members for QLocale

The following members of class QLocale are deprecated. We strongly advise against using them in new code.

Obsolete Member Function Documentation

 
[static] QList<QLocale::Country> QLocale::countriesForLanguage(QLocale::Language language)

This function is deprecated. We strongly advise against using it in new code.

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

See Also

See also matchingLocales()

Vous avez aimé ce tutoriel ? Alors partagez-le en cliquant sur les boutons suivants : Viadeo Twitter Facebook Share on Google+