NAME

DateTime::LocaleCatalog - Provides a list of all valid locale names

SYNOPSIS

See DateTime::Locale for usage details.

DESCRIPTION

This module contains a list of all known locales.

LOCALES

Any method taking locale id or name arguments should use one of the values listed below. Ids and names are case sensitive.

Always select the closest matching locale - for example, French Canadians would choose fr_CA over fr - and always use locale ids in preference to names; locale ids offer greater compatibility when using localized third party modules.

Many of the available locales are the same as other, more generic locales for datetime information. In that case, we simply load the more generic class. However, the various methods related to name, territory, and variant return the values for the requested locale.

The available locales are:

Locale id           Locale name
==================================================
aa                  Afar
aa_DJ               Afar Djibouti
aa_ER               Afar Eritrea
aa_ER_SAAHO         Afar Eritrea Saaho
aa_ET               Afar Ethiopia
af                  Afrikaans
af_NA               Afrikaans Namibia
af_ZA               Afrikaans South Africa
ak                  Akan
ak_GH               Akan Ghana
am                  Amharic
am_ET               Amharic Ethiopia
ar                  Arabic
ar_AE               Arabic United Arab Emirates
ar_BH               Arabic Bahrain
ar_DZ               Arabic Algeria
ar_EG               Arabic Egypt
ar_IQ               Arabic Iraq
ar_JO               Arabic Jordan
ar_KW               Arabic Kuwait
ar_LB               Arabic Lebanon
ar_LY               Arabic Libya
ar_MA               Arabic Morocco
ar_OM               Arabic Oman
ar_QA               Arabic Qatar
ar_SA               Arabic Saudi Arabia
ar_SD               Arabic Sudan
ar_SY               Arabic Syria
ar_TN               Arabic Tunisia
ar_YE               Arabic Yemen
as                  Assamese
as_IN               Assamese India
az                  Azerbaijani
az_AZ               Azerbaijani Azerbaijan
az_Cyrl             Azerbaijani (Cyrillic)
az_Cyrl_AZ          Azerbaijani Azerbaijan (Cyrillic)
az_Latn             Azerbaijani (Latin)
az_Latn_AZ          Azerbaijani Azerbaijan (Latin)
be                  Belarusian
be_BY               Belarusian Belarus
bg                  Bulgarian
bg_BG               Bulgarian Bulgaria
bn                  Bengali
bn_BD               Bengali Bangladesh
bn_IN               Bengali India
bs                  Bosnian
bs_BA               Bosnian Bosnia and Herzegovina
byn                 Blin
byn_ER              Blin Eritrea
ca                  Catalan
ca_ES               Catalan Spain
cch                 Atsam
cch_NG              Atsam Nigeria
cs                  Czech
cs_CZ               Czech Czech Republic
cy                  Welsh
cy_GB               Welsh United Kingdom
da                  Danish
da_DK               Danish Denmark
de                  German
de_AT               German Austria
de_BE               German Belgium
de_CH               German Switzerland
de_DE               German Germany
de_LI               German Liechtenstein
de_LU               German Luxembourg
dz                  Dzongkha
dz_BT               Dzongkha Bhutan
ee                  Ewe
ee_GH               Ewe Ghana
ee_TG               Ewe Togo
el                  Greek
el_CY               Greek Cyprus
el_GR               Greek Greece
el_POLYTONI         Greek
en                  English
en_AS               English American Samoa
en_AU               English Australia
en_BE               English Belgium
en_BW               English Botswana
en_BZ               English Belize
en_CA               English Canada
en_GB               English United Kingdom
en_GU               English Guam
en_HK               English Hong Kong SAR China
en_IE               English Ireland
en_IN               English India
en_JM               English Jamaica
en_MH               English Marshall Islands
en_MP               English Northern Mariana Islands
en_MT               English Malta
en_NA               English Namibia
en_NZ               English New Zealand
en_PH               English Philippines
en_PK               English Pakistan
en_SG               English Singapore
en_TT               English Trinidad and Tobago
en_UM               English United States Minor Outlying Islands
en_US               English United States
en_US_POSIX         English United States Posix
en_VI               English U.S. Virgin Islands
en_ZA               English South Africa
en_ZW               English Zimbabwe
eo                  Esperanto
es                  Spanish
es_AR               Spanish Argentina
es_BO               Spanish Bolivia
es_CL               Spanish Chile
es_CO               Spanish Colombia
es_CR               Spanish Costa Rica
es_DO               Spanish Dominican Republic
es_EC               Spanish Ecuador
es_ES               Spanish Spain
es_GT               Spanish Guatemala
es_HN               Spanish Honduras
es_MX               Spanish Mexico
es_NI               Spanish Nicaragua
es_PA               Spanish Panama
es_PE               Spanish Peru
es_PR               Spanish Puerto Rico
es_PY               Spanish Paraguay
es_SV               Spanish El Salvador
es_US               Spanish United States
es_UY               Spanish Uruguay
es_VE               Spanish Venezuela
et                  Estonian
et_EE               Estonian Estonia
eu                  Basque
eu_ES               Basque Spain
fi                  Finnish
fi_FI               Finnish Finland
fo                  Faroese
fo_FO               Faroese Faroe Islands
fr                  French
fr_BE               French Belgium
fr_CA               French Canada
fr_CH               French Switzerland
fr_FR               French France
fr_LU               French Luxembourg
fr_MC               French Monaco
fur                 Friulian
fur_IT              Friulian Italy
ga                  Irish
ga_IE               Irish Ireland
gaa                 Ga
gaa_GH              Ga Ghana
gez                 Geez
gez_ER              Geez Eritrea
gez_ET              Geez Ethiopia
gl                  Galician
gl_ES               Galician Spain
gu                  Gujarati
gu_IN               Gujarati India
gv                  Manx
gv_GB               Manx United Kingdom
ha                  Hausa
ha_Arab             Hausa (Arabic)
ha_Arab_NG          Hausa Nigeria (Arabic)
ha_GH               Hausa Ghana
ha_Latn             Hausa (Latin)
ha_Latn_GH          Hausa Ghana (Latin)
ha_Latn_NE          Hausa Niger (Latin)
ha_Latn_NG          Hausa Nigeria (Latin)
ha_NE               Hausa Niger
ha_NG               Hausa Nigeria
haw                 Hawaiian
haw_US              Hawaiian United States
he                  Hebrew
he_IL               Hebrew Israel
hi                  Hindi
hi_IN               Hindi India
hr                  Croatian
hr_HR               Croatian Croatia
hu                  Hungarian
hu_HU               Hungarian Hungary
hy                  Armenian
hy_AM               Armenian Armenia
hy_AM_REVISED       Armenian Armenia Revised
ia                  Interlingua
id                  Indonesian
id_ID               Indonesian Indonesia
ig                  Igbo
ig_NG               Igbo Nigeria
is                  Icelandic
is_IS               Icelandic Iceland
it                  Italian
it_CH               Italian Switzerland
it_IT               Italian Italy
iu                  Inuktitut
ja                  Japanese
ja_JP               Japanese Japan
ka                  Georgian
ka_GE               Georgian Georgia
kaj                 Jju
kaj_NG              Jju Nigeria
kam                 Kamba
kam_KE              Kamba Kenya
kcg                 Tyap
kcg_NG              Tyap Nigeria
kfo                 Koro
kfo_NG              Koro Nigeria
kk                  Kazakh
kk_KZ               Kazakh Kazakhstan
kl                  Kalaallisut
kl_GL               Kalaallisut Greenland
km                  Khmer
km_KH               Khmer Cambodia
kn                  Kannada
kn_IN               Kannada India
ko                  Korean
ko_KR               Korean South Korea
kok                 Konkani
kok_IN              Konkani India
kw                  Cornish
kw_GB               Cornish United Kingdom
ln                  Lingala
ln_CD               Lingala Congo (Kinshasa)
ln_CG               Lingala Congo (Brazzaville)
lo                  Lao
lo_LA               Lao Laos
lt                  Lithuanian
lt_LT               Lithuanian Lithuania
lv                  Latvian
lv_LV               Latvian Latvia
mk                  Macedonian
mk_MK               Macedonian Macedonia
ml                  Malayalam
ml_IN               Malayalam India
mn                  Mongolian
mn_MN               Mongolian Mongolia
mr                  Marathi
mr_IN               Marathi India
ms                  Malay
ms_BN               Malay Brunei
ms_MY               Malay Malaysia
mt                  Maltese
mt_MT               Maltese Malta
nb                  Norwegian Bokmål
nb_NO               Norwegian Bokmål Norway
ne                  Nepali
ne_NP               Nepali Nepal
nl                  Dutch
nl_BE               Dutch Belgium
nl_NL               Dutch Netherlands
nn                  Norwegian Nynorsk
nn_NO               Norwegian Nynorsk Norway
nr                  South Ndebele
nr_ZA               South Ndebele South Africa
nso                 Northern Sotho
nso_ZA              Northern Sotho South Africa
ny                  Nyanja; Chichewa; Chewa
ny_MW               Nyanja; Chichewa; Chewa Malawi
om                  Oromo
om_ET               Oromo Ethiopia
om_KE               Oromo Kenya
pa                  Punjabi
pa_Arab             Punjabi (Arabic)
pa_Arab_PK          Punjabi Pakistan (Arabic)
pa_Guru             Punjabi (Gurmukhi)
pa_Guru_IN          Punjabi India (Gurmukhi)
pa_IN               Punjabi India
pa_PK               Punjabi Pakistan
pl                  Polish
pl_PL               Polish Poland
pt                  Portuguese
pt_BR               Portuguese Brazil
pt_PT               Portuguese Portugal
ro                  Romanian
ro_RO               Romanian Romania
root                Root
ru                  Russian
ru_RU               Russian Russia
ru_UA               Russian Ukraine
rw                  Kinyarwanda
rw_RW               Kinyarwanda Rwanda
sh                  Serbo-Croatian
sh_BA               Serbo-Croatian Bosnia and Herzegovina
sh_CS               Serbo-Croatian Serbia And Montenegro
sh_YU               Serbo-Croatian
sid                 Sidamo
sid_ET              Sidamo Ethiopia
sk                  Slovak
sk_SK               Slovak Slovakia
sl                  Slovenian
sl_SI               Slovenian Slovenia
so                  Somali
so_DJ               Somali Djibouti
so_ET               Somali Ethiopia
so_KE               Somali Kenya
so_SO               Somali Somalia
sq                  Albanian
sq_AL               Albanian Albania
sr                  Serbian
sr_BA               Serbian Bosnia and Herzegovina
sr_CS               Serbian Serbia And Montenegro
sr_Cyrl             Serbian (Cyrillic)
sr_Cyrl_BA          Serbian Bosnia and Herzegovina (Cyrillic)
sr_Cyrl_CS          Serbian Serbia And Montenegro (Cyrillic)
sr_Cyrl_ME          Serbian Montenegro (Cyrillic)
sr_Cyrl_RS          Serbian Serbia (Cyrillic)
sr_Cyrl_YU          Serbian (Cyrillic)
sr_Latn             Serbian (Latin)
sr_Latn_BA          Serbian Bosnia and Herzegovina (Latin)
sr_Latn_CS          Serbian Serbia And Montenegro (Latin)
sr_Latn_ME          Serbian Montenegro (Latin)
sr_Latn_RS          Serbian Serbia (Latin)
sr_Latn_YU          Serbian (Latin)
sr_ME               Serbian Montenegro
sr_RS               Serbian Serbia
sr_YU               Serbian
ss                  Swati
ss_ZA               Swati South Africa
st                  Southern Sotho
st_ZA               Southern Sotho South Africa
sv                  Swedish
sv_FI               Swedish Finland
sv_SE               Swedish Sweden
sw                  Swahili
sw_KE               Swahili Kenya
sw_TZ               Swahili Tanzania
syr                 Syriac
syr_SY              Syriac Syria
ta                  Tamil
ta_IN               Tamil India
te                  Telugu
te_IN               Telugu India
tg                  Tajik
tg_TJ               Tajik Tajikistan
th                  Thai
th_TH               Thai Thailand
ti                  Tigrinya
ti_ER               Tigrinya Eritrea
ti_ET               Tigrinya Ethiopia
tig                 Tigre
tig_ER              Tigre Eritrea
tn                  Tswana
tn_ZA               Tswana South Africa
tr                  Turkish
tr_TR               Turkish Turkey
ts                  Tsonga
ts_ZA               Tsonga South Africa
uk                  Ukrainian
uk_UA               Ukrainian Ukraine
uz                  Uzbek
uz_AF               Uzbek Afghanistan
uz_Arab             Uzbek (Arabic)
uz_Arab_AF          Uzbek Afghanistan (Arabic)
uz_Cyrl             Uzbek (Cyrillic)
uz_Cyrl_UZ          Uzbek Uzbekistan (Cyrillic)
uz_Latn             Uzbek (Latin)
uz_Latn_UZ          Uzbek Uzbekistan (Latin)
uz_UZ               Uzbek Uzbekistan
ve                  Venda
ve_ZA               Venda South Africa
vi                  Vietnamese
vi_VN               Vietnamese Vietnam
wal                 Walamo
wal_ET              Walamo Ethiopia
xh                  Xhosa
xh_ZA               Xhosa South Africa
yo                  Yoruba
yo_NG               Yoruba Nigeria
zh                  Chinese
zh_CN               Chinese China
zh_HK               Chinese Hong Kong SAR China
zh_Hans             Chinese (Simplified Han)
zh_Hans_CN          Chinese China (Simplified Han)
zh_Hans_SG          Chinese Singapore (Simplified Han)
zh_Hant             Chinese (Traditional Han)
zh_Hant_HK          Chinese Hong Kong SAR China (Traditional Han)
zh_Hant_MO          Chinese Macao SAR China (Traditional Han)
zh_Hant_TW          Chinese Taiwan (Traditional Han)
zh_MO               Chinese Macao SAR China
zh_SG               Chinese Singapore
zh_TW               Chinese Taiwan
zu                  Zulu
zu_ZA               Zulu South Africa

There are also many aliases available, mostly for three-letter language codes, these are:

Locale id           Is an alias for
==================================================
C                   en_US_POSIX
POSIX               en_US_POSIX
afr                 af
afr_ZA              af_ZA
alb                 sq
alb_AL              sq_AL
amh                 am
amh_ET              am_ET
ara                 ar
ara_AE              ar_AE
ara_BH              ar_BH
ara_DZ              ar_DZ
ara_EG              ar_EG
ara_IQ              ar_IQ
ara_JO              ar_JO
ara_KW              ar_KW
ara_LB              ar_LB
ara_LY              ar_LY
ara_MA              ar_MA
ara_OM              ar_OM
ara_QA              ar_QA
ara_SA              ar_SA
ara_SD              ar_SD
ara_SY              ar_SY
ara_TN              ar_TN
ara_YE              ar_YE
arm                 hy
arm_AM              hy_AM
arm_AM_REVISED      hy_AM_REVISED
aze                 az
aze_AZ              az_AZ
baq                 eu
baq_ES              eu_ES
baq_ES_PREEURO      eu_ES
bel                 be
bel_BY              be_BY
ben                 bn
ben_IN              bn_IN
bul                 bg
bul_BG              bg_BG
cat                 ca
cat_ES              ca_ES
cat_ES_PREEURO      ca_ES
ces                 cs
ces_CZ              cs_CZ
chi                 zh
chi_CN              zh_CN
chi_HK              zh_HK
chi_MO              zh_MO
chi_SG              zh_SG
chi_TW              zh_TW
chi_TW_STROKE       zh_TW
cor                 kw
cor_GB              kw_GB
cze                 cs
cze_CZ              cs_CZ
dan                 da
dan_DK              da_DK
deu                 de
deu_AT              de_AT
deu_AT_PREEURO      de_AT
deu_BE              de_BE
deu_CH              de_CH
deu_DE              de_DE
deu_DE_PREEURO      de_DE
deu_LI              de_LI
deu_LU              de_LU
deu_LU_PREEURO      de_LU
dut                 nl
dut_BE              nl_BE
dut_BE_PREEURO      nl_BE
dut_NL              nl_NL
dut_NL_PREEURO      nl_NL
ell                 el
ell_GR              el_GR
ell_GR_PREEURO      el_GR
eng                 en
eng_AS              en_AS
eng_AU              en_AU
eng_BE              en_BE
eng_BE_PREEURO      en_BE
eng_BW              en_BW
eng_BZ              en_BZ
eng_CA              en_CA
eng_GB              en_GB
eng_GB_EURO         en_GB
eng_GU              en_GU
eng_HK              en_HK
eng_IE              en_IE
eng_IE_PREEURO      en_IE
eng_IN              en_IN
eng_JM              en_JM
eng_MH              en_MH
eng_MP              en_MP
eng_MT              en_MT
eng_NZ              en_NZ
eng_PH              en_PH
eng_SG              en_SG
eng_TT              en_TT
eng_UM              en_UM
eng_US              en_US
eng_US_POSIX        en_US_POSIX
eng_VI              en_VI
eng_ZA              en_ZA
eng_ZW              en_ZW
epo                 eo
est                 et
est_EE              et_EE
eus                 eu
eus_ES              eu_ES
eus_ES_PREEURO      eu_ES
fao                 fo
fao_FO              fo_FO
fin                 fi
fin_FI              fi_FI
fin_FI_PREEURO      fi_FI
fra                 fr
fra_BE              fr_BE
fra_BE_PREEURO      fr_BE
fra_CA              fr_CA
fra_CH              fr_CH
fra_FR              fr_FR
fra_FR_PREEURO      fr_FR
fra_LU              fr_LU
fra_LU_PREEURO      fr_LU
fra_MC              fr_MC
fre                 fr
fre_BE              fr_BE
fre_BE_PREEURO      fr_BE
fre_CA              fr_CA
fre_CH              fr_CH
fre_FR              fr_FR
fre_FR_PREEURO      fr_FR
fre_LU              fr_LU
fre_LU_PREEURO      fr_LU
fre_MC              fr_MC
geo                 ka
geo_GE              ka_GE
ger                 de
ger_AT              de_AT
ger_AT_PREEURO      de_AT
ger_BE              de_BE
ger_CH              de_CH
ger_DE              de_DE
ger_DE_PREEURO      de_DE
ger_LI              de_LI
ger_LU              de_LU
ger_LU_PREEURO      de_LU
gle                 ga
gle_IE              ga_IE
gle_IE_PREEURO      ga_IE
glg                 gl
glg_ES              gl_ES
glg_ES_PREEURO      gl_ES
glv                 gv
glv_GB              gv_GB
gre                 el
gre_GR              el_GR
gre_GR_PREEURO      el_GR
guj                 gu
guj_IN              gu_IN
heb                 he
heb_IL              he_IL
hin                 hi
hin_IN              hi_IN
hrv                 hr
hrv_HR              hr_HR
hun                 hu
hun_HU              hu_HU
hye                 hy
hye_AM              hy_AM
hye_AM_REVISED      hy_AM_REVISED
ice                 is
ice_IS              is_IS
ind                 id
ind_ID              id_ID
isl                 is
isl_IS              is_IS
ita                 it
ita_CH              it_CH
ita_IT              it_IT
ita_IT_PREEURO      it_IT
iw                  he
iw_IL               he_IL
jpn                 ja
jpn_JP              ja_JP
kal                 kl
kal_GL              kl_GL
kan                 kn
kan_IN              kn_IN
kat                 ka
kat_GE              ka_GE
kaz                 kk
kaz_KZ              kk_KZ
kor                 ko
kor_KR              ko_KR
lav                 lv
lav_LV              lv_LV
lit                 lt
lit_LT              lt_LT
mac                 mk
mac_MK              mk_MK
mar                 mr
mar_IN              mr_IN
may                 ms
may_BN              ms_BN
may_MY              ms_MY
mkd                 mk
mkd_MK              mk_MK
mlt                 mt
mlt_MT              mt_MT
mon                 mn
mon_MN              mn_MN
msa                 ms
msa_BN              ms_BN
msa_MY              ms_MY
nld                 nl
nld_BE              nl_BE
nld_BE_PREEURO      nl_BE
nld_NL              nl_NL
nld_NL_PREEURO      nl_NL
nno                 nn
nno_NO              nn_NO
no                  nn
no_NO               nn_NO
no_NO_NY            nn_NO
nob                 nb
nob_NO              nb_NO
orm                 om
orm_ET              om_ET
orm_KE              om_KE
pan                 pa
pan_IN              pa_IN
pol                 pl
pol_PL              pl_PL
por                 pt
por_BR              pt_BR
por_PT              pt_PT
por_PT_PREEURO      pt_PT
ron                 ro
ron_RO              ro_RO
rum                 ro
rum_RO              ro_RO
rus                 ru
rus_RU              ru_RU
rus_UA              ru_UA
scc                 sr
scc_YU              sr_YU
scr                 hr
scr_HR              hr_HR
slk                 sk
slk_SK              sk_SK
slo                 sk
slo_SK              sk_SK
slv                 sl
slv_SI              sl_SI
som                 so
som_DJ              so_DJ
som_ET              so_ET
som_KE              so_KE
som_SO              so_SO
spa                 es
spa_AR              es_AR
spa_BO              es_BO
spa_CL              es_CL
spa_CO              es_CO
spa_CR              es_CR
spa_DO              es_DO
spa_EC              es_EC
spa_ES              es_ES
spa_ES_PREEURO      es_ES
spa_GT              es_GT
spa_HN              es_HN
spa_MX              es_MX
spa_NI              es_NI
spa_PA              es_PA
spa_PE              es_PE
spa_PR              es_PR
spa_PY              es_PY
spa_SV              es_SV
spa_US              es_US
spa_UY              es_UY
spa_VE              es_VE
sqi                 sq
sqi_AL              sq_AL
srp                 sr
srp_YU              sr_YU
swa                 sw
swa_KE              sw_KE
swa_TZ              sw_TZ
swe                 sv
swe_FI              sv_FI
swe_SE              sv_SE
tam                 ta
tam_IN              ta_IN
tel                 te
tel_IN              te_IN
tha                 th
tha_TH              th_TH
tur                 tr
tur_TR              tr_TR
ukr                 uk
ukr_UA              uk_UA
uzb                 uz
uzb_UZ              uz_UZ
vie                 vi
vie_VN              vi_VN
zho                 zh
zho_CN              zh_CN
zho_HK              zh_HK
zho_MO              zh_MO
zho_SG              zh_SG
zho_TW              zh_TW
zho_TW_STROKE       zh_TW