Skip to content

CLDR-19203 Update currencies: BGN to EUR #5289

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Merged
btangmu merged 2 commits into from
Jan 16, 2026
Merged

CLDR-19203 Update currencies: BGN to EUR #5289

btangmu merged 2 commits into from
Jan 16, 2026

Conversation

@btangmu
Copy link
Member

@btangmu btangmu commented Jan 14, 2026 •
edited
Loading

  • Update 2 XML files and one markdown file

  • CLDR-19203

  • This PR completes the ticket.

ALLOW_MANY_COMMITS=true

@btangmu btangmu self-assigned this Jan 14, 2026
@btangmu
Copy link
Member Author

btangmu commented Jan 14, 2026

I followed instructions at
https://cldr.unicode.org/development/updating-codes/update-currency-codes

I downloaded the updated versions of the two XML files. I ran the tool as follows:

$ java -DCLDR_DIR=$(pwd) -Dmethod=generateCurrencyItems -jar tools/cldr-code/target/cldr-code.jar org.unicode.cldr.tool.CountItems
>> org.unicode.cldr.tool.CountItems
Calling -Dmethod=generateCurrencyItems
AED	[UAE Dirham,	AE [United Arab Emirates],	784]
AFN	[Afghani,	AF [Afghanistan],	971]
ALL	[Lek,	AL [Albania],	8]
AMD	[Armenian Dram,	AM [Armenia],	51]
AOA	[Kwanza,	AO [Angola],	973]
ARS	[Argentine Peso,	AR [Argentina],	32]
AUD	[Australian Dollar,	AU [Australia],	36]
	[Australian Dollar,	CC [Cocos (Keeling) Islands],	36]
	[Australian Dollar,	CX [Christmas Island],	36]
	[Australian Dollar,	HM [Heard Island and McDonald Islands],	36]
	[Australian Dollar,	KI [Kiribati],	36]
	[Australian Dollar,	NF [Norfolk Island],	36]
	[Australian Dollar,	NR [Nauru],	36]
	[Australian Dollar,	TV [Tuvalu],	36]
AWG	[Aruban Florin,	AW [Aruba],	533]
AZN	[Azerbaijan Manat,	AZ [Azerbaijan],	944]
BAM	[Convertible Mark,	BA [Bosnia and Herzegovina],	977]
BBD	[Barbados Dollar,	BB [Barbados],	52]
BDT	[Taka,	BD [Bangladesh],	50]
BHD	[Bahraini Dinar,	BH [Bahrain],	48]
BIF	[Burundi Franc,	BI [Burundi],	108]
BMD	[Bermudian Dollar,	BM [Bermuda],	60]
BND	[Brunei Dollar,	BN [Brunei Darussalam],	96]
BOB	[Boliviano,	BO [Bolivia],	68]
BOV	[Mvdol,	BO [Bolivia],	984]
BRL	[Brazilian Real,	BR [Brazil],	986]
BSD	[Bahamian Dollar,	BS [Bahamas],	44]
BTN	[Ngultrum,	BT [Bhutan],	64]
BWP	[Pula,	BW [Botswana],	72]
BYN	[Belarusian Ruble,	BY [Belarus],	933]
BZD	[Belize Dollar,	BZ [Belize],	84]
CAD	[Canadian Dollar,	CA [Canada],	124]
CDF	[Congolese Franc,	CD [The Democratic Republic of the Congo],	976]
CHE	[WIR Euro,	CH [Switzerland],	947]
CHF	[Swiss Franc,	CH [Switzerland],	756]
	[Swiss Franc,	LI [Liechtenstein],	756]
CHW	[WIR Franc,	CH [Switzerland],	948]
CLF	[Unidad de Fomento,	CL [Chile],	990]
CLP	[Chilean Peso,	CL [Chile],	152]
CNH	[Yuan (offshore),	CN [China],	0]
CNY	[Yuan Renminbi,	CN [China],	156]
COP	[Colombian Peso,	CO [Colombia],	170]
COU	[Unidad de Valor Real,	CO [Colombia],	970]
CRC	[Costa Rican Colon,	CR [Costa Rica],	188]
CUP	[Cuban Peso,	CU [Cuba],	192]
CVE	[Cabo Verde Escudo,	CV [Cabo Verde▪Cape Verde],	132]
CZK	[Czech Koruna,	CZ [Czechia▪Czech Republic],	203]
DJF	[Djibouti Franc,	DJ [Djibouti],	262]
DKK	[Danish Krone,	DK [Denmark],	208]
	[Danish Krone,	FO [Faroe Islands],	208]
	[Danish Krone,	GL [Greenland],	208]
DOP	[Dominican Peso,	DO [Dominican Republic],	214]
DZD	[Algerian Dinar,	DZ [Algeria],	12]
EGP	[Egyptian Pound,	EG [Egypt],	818]
ERN	[Nakfa,	ER [Eritrea],	232]
ETB	[Ethiopian Birr,	ET [Ethiopia],	230]
EUR	[Euro,	AD [Andorra],	978]
	[Euro,	AT [Austria],	978]
	[Euro,	AX [Åland Islands],	978]
	[Euro,	BE [Belgium],	978]
	[Euro,	BG [Bulgaria],	978]
	[Euro,	BL [Saint Barthélemy],	978]
	[Euro,	CY [Cyprus],	978]
	[Euro,	DE [Germany],	978]
	[Euro,	EA [Ceuta, Melilla],	978]
	[Euro,	EE [Estonia],	978]
	[Euro,	ES [Spain],	978]
	[Euro,	EU [European Union],	978]
	[Euro,	FI [Finland],	978]
	[Euro,	FR [France],	978]
	[Euro,	GF [French Guiana],	978]
	[Euro,	GP [Guadeloupe],	978]
	[Euro,	GR [Greece],	978]
	[Euro,	HR [Croatia],	978]
	[Euro,	IC [Canary Islands],	978]
	[Euro,	IE [Ireland],	978]
	[Euro,	IT [Italy],	978]
	[Euro,	LT [Lithuania],	978]
	[Euro,	LU [Luxembourg],	978]
	[Euro,	LV [Latvia],	978]
	[Euro,	MC [Monaco],	978]
	[Euro,	ME [Montenegro],	978]
	[Euro,	MF [Saint Martin (French part)],	978]
	[Euro,	MQ [Martinique],	978]
	[Euro,	MT [Malta],	978]
	[Euro,	NL [Netherlands],	978]
	[Euro,	PM [Saint Pierre and Miquelon],	978]
	[Euro,	PT [Portugal],	978]
	[Euro,	RE [Réunion],	978]
	[Euro,	SI [Slovenia],	978]
	[Euro,	SK [Slovakia],	978]
	[Euro,	SM [San Marino],	978]
	[Euro,	TF [French Southern Territories],	978]
	[Euro,	VA [Holy See (Vatican City State)],	978]
	[Euro,	XK [Kosovo],	978]
	[Euro,	YT [Mayotte],	978]
FJD	[Fiji Dollar,	FJ [Fiji],	242]
FKP	[Falkland Islands Pound,	FK [Falkland Islands (Malvinas)],	238]
GBP	[Pound Sterling,	GB [United Kingdom],	826]
	[Pound Sterling,	GG [Guernsey],	826]
	[Pound Sterling,	GS [South Georgia and the South Sandwich Islands],	826]
	[Pound Sterling,	IM [Isle of Man],	826]
	[Pound Sterling,	JE [Jersey],	826]
	[Pound Sterling,	TA [Tristan da Cunha],	826]
GEL	[Lari,	GE [Georgia],	981]
GHS	[Ghana Cedi,	GH [Ghana],	936]
GIP	[Gibraltar Pound,	GI [Gibraltar],	292]
GMD	[Dalasi,	GM [Gambia],	270]
GNF	[Guinean Franc,	GN [Guinea],	324]
GTQ	[Quetzal,	GT [Guatemala],	320]
GYD	[Guyana Dollar,	GY [Guyana],	328]
HKD	[Hong Kong Dollar,	HK [Hong Kong],	344]
HNL	[Lempira,	HN [Honduras],	340]
HTG	[Gourde,	HT [Haiti],	332]
HUF	[Forint,	HU [Hungary],	348]
IDR	[Rupiah,	ID [Indonesia],	360]
ILS	[New Israeli Sheqel,	IL [Israel],	376]
	[New Israeli Sheqel,	PS [State of Palestine],	376]
INR	[Indian Rupee,	BT [Bhutan],	356]
	[Indian Rupee,	IN [India],	356]
IQD	[Iraqi Dinar,	IQ [Iraq],	368]
IRR	[Iranian Rial,	IR [Islamic Republic of Iran],	364]
ISK	[Iceland Krona,	IS [Iceland],	352]
JMD	[Jamaican Dollar,	JM [Jamaica],	388]
JOD	[Jordanian Dinar,	JO [Jordan],	400]
	[Jordanian Dinar,	PS [State of Palestine],	400]
JPY	[Yen,	JP [Japan],	392]
KES	[Kenyan Shilling,	KE [Kenya],	404]
KGS	[Som,	KG [Kyrgyzstan],	417]
KHR	[Riel,	KH [Cambodia],	116]
KMF	[Comorian Franc ,	KM [Comoros],	174]
KPW	[North Korean Won,	KP [Democratic People's Republic of Korea],	408]
KRW	[Won,	KR [Republic of Korea],	410]
KWD	[Kuwaiti Dinar,	KW [Kuwait],	414]
KYD	[Cayman Islands Dollar,	KY [Cayman Islands],	136]
KZT	[Tenge,	KZ [Kazakhstan],	398]
LAK	[Lao Kip,	LA [Lao People's Democratic Republic],	418]
LBP	[Lebanese Pound,	LB [Lebanon],	422]
LKR	[Sri Lanka Rupee,	LK [Sri Lanka],	144]
LRD	[Liberian Dollar,	LR [Liberia],	430]
LSL	[Loti,	LS [Lesotho],	426]
LYD	[Libyan Dinar,	LY [Libya],	434]
MAD	[Moroccan Dirham,	EH [Western Sahara],	504]
	[Moroccan Dirham,	MA [Morocco],	504]
MDL	[Moldovan Leu,	MD [Moldova],	498]
MGA	[Malagasy Ariary,	MG [Madagascar],	969]
MKD	[Denar,	MK [North Macedonia],	807]
MMK	[Kyat,	MM [Myanmar],	104]
MNT	[Tugrik,	MN [Mongolia],	496]
MOP	[Pataca,	MO [Macao],	446]
MRU	[Ouguiya,	MR [Mauritania],	929]
MUR	[Mauritius Rupee,	MU [Mauritius],	480]
MVR	[Rufiyaa,	MV [Maldives],	462]
MWK	[Malawi Kwacha,	MW [Malawi],	454]
MXN	[Mexican Peso,	MX [Mexico],	484]
MXV	[Mexican Unidad de Inversion (UDI),	MX [Mexico],	979]
MYR	[Malaysian Ringgit,	MY [Malaysia],	458]
MZN	[Mozambique Metical,	MZ [Mozambique],	943]
NAD	[Namibia Dollar,	NA [Namibia],	516]
NGN	[Naira,	NG [Nigeria],	566]
NIO	[Cordoba Oro,	NI [Nicaragua],	558]
NOK	[Norwegian Krone,	BV [Bouvet Island],	578]
	[Norwegian Krone,	NO [Norway],	578]
	[Norwegian Krone,	SJ [Svalbard and Jan Mayen],	578]
NPR	[Nepalese Rupee,	NP [Nepal],	524]
NZD	[New Zealand Dollar,	CK [Cook Islands],	554]
	[New Zealand Dollar,	NU [Niue],	554]
	[New Zealand Dollar,	NZ [New Zealand],	554]
	[New Zealand Dollar,	PN [Pitcairn],	554]
	[New Zealand Dollar,	TK [Tokelau],	554]
OMR	[Rial Omani,	OM [Oman],	512]
PAB	[Balboa,	PA [Panama],	590]
PEN	[Sol,	PE [Peru],	604]
PGK	[Kina,	PG [Papua New Guinea],	598]
PHP	[Philippine Peso,	PH [Philippines],	608]
PKR	[Pakistan Rupee,	PK [Pakistan],	586]
PLN	[Zloty,	PL [Poland],	985]
PYG	[Guarani,	PY [Paraguay],	600]
QAR	[Qatari Rial,	QA [Qatar],	634]
RON	[Romanian Leu,	RO [Romania],	946]
RSD	[Serbian Dinar,	RS [Serbia],	941]
RUB	[Russian Ruble,	RU [Russian Federation],	643]
RWF	[Rwanda Franc,	RW [Rwanda],	646]
SAR	[Saudi Riyal,	SA [Saudi Arabia],	682]
SBD	[Solomon Islands Dollar,	SB [Solomon Islands],	90]
SCR	[Seychelles Rupee,	SC [Seychelles],	690]
SDG	[Sudanese Pound,	SD [Sudan],	938]
SEK	[Swedish Krona,	SE [Sweden],	752]
SGD	[Singapore Dollar,	SG [Singapore],	702]
SHP	[Saint Helena Pound,	AC [Ascension Island],	654]
	[Saint Helena Pound,	SH [Saint Helena, Ascension and Tristan da Cunha],	654]
SLE	[Leone,	SL [Sierra Leone],	925]
SOS	[Somali Shilling,	SO [Somalia],	706]
SRD	[Surinam Dollar,	SR [Suriname],	968]
SSP	[South Sudanese Pound,	SS [South Sudan],	728]
STN	[Dobra,	ST [Sao Tome and Principe],	930]
SYP	[Syrian Pound,	SY [Syrian Arab Republic],	760]
SZL	[Lilangeni,	SZ [Eswatini▪eSwatini▪Swaziland],	748]
THB	[Baht,	TH [Thailand],	764]
TJS	[Somoni,	TJ [Tajikistan],	972]
TMT	[Turkmenistan New Manat,	TM [Turkmenistan],	934]
TND	[Tunisian Dinar,	TN [Tunisia],	788]
TOP	[Pa’anga,	TO [Tonga],	776]
TRY	[Turkish Lira,	TR [Türkiye▪Turkey],	949]
TTD	[Trinidad and Tobago Dollar,	TT [Trinidad and Tobago],	780]
TWD	[New Taiwan Dollar,	TW [Taiwan, Province of China],	901]
TZS	[Tanzanian Shilling,	TZ [United Republic of Tanzania],	834]
UAH	[Hryvnia,	UA [Ukraine],	980]
UGX	[Uganda Shilling,	UG [Uganda],	800]
USD	[US Dollar,	AS [American Samoa],	840]
	[US Dollar,	BQ [Bonaire, Sint Eustatius and Saba],	840]
	[US Dollar,	DG [Diego Garcia],	840]
	[US Dollar,	EC [Ecuador],	840]
	[US Dollar,	FM [Federated States of Micronesia],	840]
	[US Dollar,	GU [Guam],	840]
	[US Dollar,	HT [Haiti],	840]
	[US Dollar,	IO [British Indian Ocean Territory],	840]
	[US Dollar,	MH [Marshall Islands],	840]
	[US Dollar,	MP [Northern Mariana Islands],	840]
	[US Dollar,	PA [Panama],	840]
	[US Dollar,	PR [Puerto Rico],	840]
	[US Dollar,	PW [Palau],	840]
	[US Dollar,	SV [El Salvador],	840]
	[US Dollar,	TC [Turks and Caicos Islands],	840]
	[US Dollar,	TL [Timor-Leste],	840]
	[US Dollar,	UM [United States Minor Outlying Islands],	840]
	[US Dollar,	US [United States],	840]
	[US Dollar,	VG [British Virgin Islands],	840]
	[US Dollar,	VI [U.S. Virgin Islands],	840]
	[US Dollar,	ZW [Zimbabwe],	840]
USN	[US Dollar (Next day),	US [United States],	997]
UYI	[Uruguay Peso en Unidades Indexadas (UI),	UY [Uruguay],	940]
UYU	[Peso Uruguayo,	UY [Uruguay],	858]
UYW	[Unidad Previsional,	UY [Uruguay],	927]
UZS	[Uzbekistan Sum,	UZ [Uzbekistan],	860]
VED	[Bolívar Soberano,	VE [Venezuela],	926]
VES	[Bolívar Soberano,	VE [Venezuela],	928]
VND	[Dong,	VN [Viet Nam],	704]
VUV	[Vatu,	VU [Vanuatu],	548]
WST	[Tala,	WS [Samoa],	882]
XAD	[Arab Accounting Dinar,	ZZ [Unknown or Invalid Region],	396]
XAF	[CFA Franc BEAC,	CF [Central African Republic],	950]
	[CFA Franc BEAC,	CG [Congo],	950]
	[CFA Franc BEAC,	CM [Cameroon],	950]
	[CFA Franc BEAC,	GA [Gabon],	950]
	[CFA Franc BEAC,	GQ [Equatorial Guinea],	950]
	[CFA Franc BEAC,	TD [Chad],	950]
XAG	[Silver,	ZZ [Unknown or Invalid Region],	961]
XAU	[Gold,	ZZ [Unknown or Invalid Region],	959]
XBA	[Bond Markets Unit European Composite Unit (EURCO),	ZZ [Unknown or Invalid Region],	955]
XBB	[Bond Markets Unit European Monetary Unit (E.M.U.-6),	ZZ [Unknown or Invalid Region],	956]
XBC	[Bond Markets Unit European Unit of Account 9 (E.U.A.-9),	ZZ [Unknown or Invalid Region],	957]
XBD	[Bond Markets Unit European Unit of Account 17 (E.U.A.-17),	ZZ [Unknown or Invalid Region],	958]
XCD	[East Caribbean Dollar,	AG [Antigua and Barbuda],	951]
	[East Caribbean Dollar,	AI [Anguilla],	951]
	[East Caribbean Dollar,	DM [Dominica],	951]
	[East Caribbean Dollar,	GD [Grenada],	951]
	[East Caribbean Dollar,	KN [Saint Kitts and Nevis],	951]
	[East Caribbean Dollar,	LC [Saint Lucia],	951]
	[East Caribbean Dollar,	MS [Montserrat],	951]
	[East Caribbean Dollar,	VC [Saint Vincent and the Grenadines],	951]
XCG	[Caribbean Guilder,	CW [Curaçao],	532]
	[Caribbean Guilder,	SX [Sint Maarten (Dutch part)],	532]
XDR	[SDR (Special Drawing Right),	ZZ [Unknown or Invalid Region],	960]
XOF	[CFA Franc BCEAO,	BF [Burkina Faso],	952]
	[CFA Franc BCEAO,	BJ [Benin],	952]
	[CFA Franc BCEAO,	CI [Côte d'Ivoire],	952]
	[CFA Franc BCEAO,	GW [Guinea-Bissau],	952]
	[CFA Franc BCEAO,	ML [Mali],	952]
	[CFA Franc BCEAO,	NE [Niger],	952]
	[CFA Franc BCEAO,	SN [Senegal],	952]
	[CFA Franc BCEAO,	TG [Togo],	952]
XPD	[Palladium,	ZZ [Unknown or Invalid Region],	964]
XPF	[CFP Franc,	NC [New Caledonia],	953]
	[CFP Franc,	PF [French Polynesia],	953]
	[CFP Franc,	WF [Wallis and Futuna],	953]
XPT	[Platinum,	ZZ [Unknown or Invalid Region],	962]
XSU	[Sucre,	ZZ [Unknown or Invalid Region],	994]
XTS	[Codes specifically reserved for testing purposes,	ZZ [Unknown or Invalid Region],	963]
XUA	[ADB Unit of Account,	ZZ [Unknown or Invalid Region],	965]
XXX	[The codes assigned for transactions where no currency is
				involved,	AQ [Antarctica],	999]
	[The codes assigned for transactions where no currency is
				involved,	CP [Clipperton Island],	999]
	[The codes assigned for transactions where no currency is involved,	ZZ [Unknown or Invalid Region],	999]
YER	[Yemeni Rial,	YE [Yemen],	886]
ZAR	[Rand,	LS [Lesotho],	710]
	[Rand,	NA [Namibia],	710]
	[Rand,	ZA [South Africa],	710]
ZMW	[Zambian Kwacha,	ZM [Zambia],	967]
ZWG	[Zimbabwe Gold,	ZW [Zimbabwe],	924]

Elapsed: 0.025 seconds
Done

There was no exception. Per instructions, "If any country changes the use of a currency, verify that there is a corresponding entry in SupplementalData"; common/supplemental/supplementalData.xml already includes:

<region iso3166="BG">
    <currency iso4217="EUR" from="2026-01-01" />
    <currency iso4217="BGN" from="1999-07-05" to="2026-01-31"/>
    <currency iso4217="BGL" from="1962-01-01" to="1999-07-05"/>
    <currency iso4217="BGM" from="1952-05-12" to="1962-01-01"/>
    <currency iso4217="BGO" from="1879-07-08" to="1952-05-12"/>
</region>

Evidently it was already revised for the change from BGN to EUR.

common/bcp47/currency.xml still has

            <type name="bgn" description="Bulgarian Lev" since="1.9"/>
...
            <type name="eur" description="Euro"/>

I don't see any indication that the since attribute should be removed or that an end date should be specified, but I'd like confirmation that currency.xml is OK as-is.

en.xml shouldn't need any change -- it already has EUR and BGN.

https://cldr.unicode.org/development/updating-codes/update-currency-codes refers to a file whose location has moved:

(old:) tools/java/org/unicode/cldr/util/data/ISO4217.txt
(new:) tools/cldr-code/src/main/resources/org/unicode/cldr/util/data/ISO4217.txt

I will fix that in a second commit.

@btangmu
CLDR-19203 Update currencies: documentation
51beb6e 
-Revise update-currency-codes.md to show current location of ISO4217.txt

-Other changes to update-currency-codes.md were made automatically by VS Code editor
@btangmu btangmu requested a review from srl295 January 14, 2026 18:32
macchiati
macchiati approved these changes Jan 14, 2026
View reviewed changes
Copy link
Member

@macchiati macchiati left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks great

srl295
srl295 approved these changes Jan 15, 2026
View reviewed changes
Copy link
Member

@srl295 srl295 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is there a logknownissue to remove also? @pedberg-icu

@pedberg-icu
Copy link
Contributor

pedberg-icu commented Jan 15, 2026 •
edited by atlassian bot
Loading

is there a logknownissue to remove also? @pedberg-icu

@srl295 @btangmu Yes, see the now-related CLDR-19177 and the logKnownIssue against it in [tools/cldr-code/src/test/java/org/unicode/cldr/unittest/TestSupplementalInfo.java](https://github.com/unicode-org/cldr/pull/5289#diff-36994b58edb9853f984f3f4b991c5a1acb4753a776a6c0b8adb7037e0b10292e) added in PR #5267 per CLDR-19174.

Also aren't there some ISO4217.txt and iso4217raw.txt files that need updating, in tools/cldr-code/src/main/resources/org/unicode/cldr/util/data?

@srl295
Copy link
Member

srl295 commented Jan 15, 2026

is there a logknownissue to remove also? @pedberg-icu

@srl295 @btangmu Yes, see the now-related CLDR-19177 and the logKnownIssue against it in [tools/cldr-code/src/test/java/org/unicode/cldr/unittest/TestSupplementalInfo.java](https://github.com/unicode-org/cldr/pull/5289#diff-36994b58edb9853f984f3f4b991c5a1acb4753a776a6c0b8adb7037e0b10292e) added in PR #5267 per CLDR-19174.

Also aren't there some ISO4217.txt and iso4217raw.txt files that need updating, in tools/cldr-code/src/main/resources/org/unicode/cldr/util/data?

Yes those should update too

@btangmu
Copy link
Member Author

btangmu commented Jan 16, 2026

those should update too

Thanks! OK, I've removed the check mark from "This PR completes the ticket" and I will merge this and follow up with another PR. It looks like the remaining changes will be in different files.

@btangmu btangmu merged commit 24d0f5e into unicode-org:main Jan 16, 2026
12 checks passed
@btangmu btangmu deleted the t19203_a branch January 16, 2026 18:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@srl295 srl295 srl295 approved these changes

@macchiati macchiati macchiati approved these changes

Assignees

@btangmu btangmu

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@btangmu @pedberg-icu @srl295 @macchiati