tokfc RefSheet

Коди валют (ISO 4217)

Стане в пригоді для форм оплати, таблиць курсів або експорту рахунків: зберігайте код, показуйте символ.

Оновлено:

ВалютаКодСимволДробові одиниці
US dollarUSD$2
EuroEUR€2
British poundGBP£2
Japanese yenJPY¥0
Chinese yuanCNY¥ / 元2
Hong Kong dollarHKDHK$2
Taiwan dollarTWDNT$2
South Korean wonKRW₩0
Swiss francCHFCHF2
Canadian dollarCADC$2
Australian dollarAUDA$2
New Zealand dollarNZDNZ$2
Singapore dollarSGDS$2
Indian rupeeINR₹2
Indonesian rupiahIDRRp2
Thai bahtTHB฿2
Vietnamese dongVND₫0
Malaysian ringgitMYRRM2
Philippine pesoPHP₱2
Brazilian realBRLR$2
Mexican pesoMXNMex$2
Argentine pesoARS$2
Turkish liraTRY₺2
Russian rubleRUB₽2
Saudi riyalSAR﷼2
UAE dirhamAEDد.إ2
South African randZARR2
Polish zlotyPLNzł2
Swedish kronaSEKkr2
Norwegian kroneNOKkr2
Danish kroneDKKkr2

Примітки

Що насправді специфікує ISO 4217

ISO 4217 — це міжнародний стандарт, який присвоює кожній валюті трилітерний код, числовий код і визначену кількість знаків після коми. Літери не випадкові: перші дві зазвичай ідентифікують країну або регіон, а третя — назву валюти, тому USD означає долар США, JPY — японську єну, а EUR — євро. Стандарт також фіксує дрібну одиницю — скільки цифр йдуть після крапки, — саме це програмне забезпечення використовує для правильного округлення сум. Коли система каже «зберегти код», мається на увазі алфавітний код ISO 4217, а не символ, і ця відмінність запобігає цілому класу помилок платежів.

Чому символа ніколи недостатньо

Символи валют неоднозначні на відміну від кодів. Знак долара використовують США, Канада, Австралія, Нова Зеландія, Гонконг і Сінгапур серед інших; символи єни та юаня збігаються; знак фунта покриває британський фунт і кілька інших. Ціна, записана як "$10", не повідомляє, яка саме валюта мається на увазі. У рахунках, API та базах даних зберігання трилітерного коду повністю усуває неоднозначність, а символ стає деталлю оформлення, яку обирають у момент відображення залежно від аудиторії. Правило для будь-якої системи, що працює з грошима міжнародно, просте: зберігай код, відображай символ.

Дрібні одиниці, експоненти та округлення

Кількість знаків після коми — властивість валюти, а не глобальний налаштування. Більшість валют використовують два знаки, тому USD, EUR, GBP та CNY усі мають центи. Але японська єна та південнокорейська вона не мають дрібних одиниць — JPY 100 це сто єн без десяткових, тоді як низка динарових валют, включаючи кувейтський динар, бахреїнський динар, оманський ріал та туніський динар, використовують три знаки. Деякі валюти також мають різну дрібну одиницю для готівки та для обліку. Неправильне округлення в цих випадках може створити розбіжності в тисячі разів, тому завжди зчитуй експоненту зі стандарту, а не припускай два знаки.

Короткий код, довгий перелік крайніх випадків

Поза межами кількох основних валют у будь-якій довідковій таблиці лежать незручні випадки. Валюти підлягають реденомінації — Зімбабве приберала нулі не раз — а скасовані коди залишаються в історичних записах. Деякі території повністю використовують валюту іншої країни, тому місцевого коду немає. Криптовалюти навмисно виходять за межі ISO 4217 і використовують власні тикери, тому книга обліку, що працює з обома, повинна знати, у якому просторі імен вона знаходиться. І кілька валют мають однакову назву в різних країнах, але різні коди та вартості. Практичний висновок: код є стабільним ідентифікатором, тоді як символи, назви та навіть знаки після коми можуть змінюватися.

Часті запитання

Код EUR — це яка валюта?
EUR — це код ISO 4217 для євро, валюти більшості країн Євросоюзу. Його символ — €.
Який код у валюти Японії?
Японська єна має код ISO 4217 JPY і символ ¥. Вона не має дробових одиниць.
Чому варто зберігати трилітерний код валюти, а не символ?
Символи збігаються: один $ може означати USD, CAD, AUD тощо. Трилітерний код ISO 4217 однозначний.

Джерела

Див. також