Kody walut (ISO 4217)
Przydatne przy tworzeniu formularzy płatności, tabel kursów i eksportu faktur.
| Waluta | Kod | Symbol | Miejsca dziesiętne |
|---|---|---|---|
| dolar amerykański | USD | $ | 2 |
| euro | EUR | € | 2 |
| funt brytyjski | GBP | £ | 2 |
| jen japoński | JPY | ¥ | 0 |
| juan chiński | CNY | ¥ / 元 | 2 |
| dolar Hongkongu | HKD | HK$ | 2 |
| dolar tajwański | TWD | NT$ | 2 |
| won południowokoreański | KRW | ₩ | 0 |
| frank szwajcarski | CHF | CHF | 2 |
| dolar kanadyjski | CAD | C$ | 2 |
| dolar australijski | AUD | A$ | 2 |
| dolar nowozelandzki | NZD | NZ$ | 2 |
| dolar singapurski | SGD | S$ | 2 |
| rupia indyjska | INR | ₹ | 2 |
| rupia indonezyjska | IDR | Rp | 2 |
| baht tajski | THB | ฿ | 2 |
| dong wietnamski | VND | ₫ | 0 |
| ringgit malezyjski | MYR | RM | 2 |
| peso filipiński | PHP | ₱ | 2 |
| real brazylijski | BRL | R$ | 2 |
| peso meksykański | MXN | Mex$ | 2 |
| peso argentyński | ARS | $ | 2 |
| lira turecka | TRY | ₺ | 2 |
| rubel rosyjski | RUB | ₽ | 2 |
| riyal saudyjski | SAR | ﷼ | 2 |
| dirham ZEA | AED | د.إ | 2 |
| rand południowoafrykański | ZAR | R | 2 |
| złoty | PLN | zł | 2 |
| korona szwedzka | SEK | kr | 2 |
| korona norweska | NOK | kr | 2 |
| korona duńska | DKK | kr | 2 |
Uwagi
- Miejsca dziesiętne wynikają z ISO 4217 dla kwot gotówkowych; krypto i niektóre księgi mogą się różnić.
- Symbole się powtarzają (np. $); zapisuj zawsze trzyliterowy kod.
Czym faktycznie jest specyfikacja ISO 4217
ISO 4217 to międzynarodowy standard, który przypisuje każdej walucie trzyliterowy kod, kod numeryczny oraz określoną liczbę miejsc po przecinku. Litery nie są przypadkowe: dwie pierwsze zwykle oznaczają kraj lub region, a trzecia nawiązuje do nazwy waluty, stąd USD to dolar amerykański, JPY to jen japoński, a EUR to euro. Standard określa również jednostkę ułamkową – czyli liczbę cyfr po przecinku – co umożliwia poprawne zaokrąglanie kwot w oprogramowaniu. Gdy system mówi „przechowaj kod”, chodzi o alfabetyczny kod ISO 4217, a nie o symbol; właśnie to rozróżnienie zapobiega całemu классowi błędów w płatnościach.
Dlaczego samego symbolu nigdy dość
Symbole walut są niejednoznaczne w sposób, jakiego kody nie wykazują. Znak dolara służy dolarom USA, Kanady, Australii, Nowej Zelandii, Hongkongu i Singapuru oraz wielu innym; symbole jenа и юаня się pokrywają; znak funta obejmuje funt brytyjski i kilka innych walut. Cena zapisana jako „$10” nie mówi nic o tym, jakiej waluty dotyczy. W fakturach, interfejsach API i bazach danych przechowywanie trzyliterowego kodu całkowicie usuwa niejednoznaczność, a symbol staje się kwestią prezentacji, wybieraną w momencie wyświetlania zgodnie z odbiorcą. Zasadnicza reguła dla każdego systemu obsługującego pieniądze na arenie międzynarodowej jest prosta: przechowuj kod, wyświetlaj symbol.
Jednostki ułamkowe, eksponenty i zaokrąglanie
Liczba miejsc po przecinku to właściwość waluty, a nie globalne ustawienie. Większość walut używa dwóch cyfr, więc dolary amerykańskie, euro, funty brytyjskie i juany chińskie mają odpowiedniki centów. Jen i won południowokoreański natomiast nie mają jednostek ułamkowych – 100 JPY to sto jenów bez części ułamkowej – podczas gdy kilkanaście walut opartych na dinarze, w tym dinar kuwejcki, bahrajński, rial omański i dinar tunezyjski, używa trzech miejsc. Niektóre waluty mają także różną jednostkę ułamkową dla gotówki i księgowości. Błędne zaokrąglanie w tych sytuacjach może prowadzić do różnic rzędu stuokrotności, dlatego zawsze odczytuj eksponent ze standardu, a nie zakładaj, że są dwa miejsca dziesiętne.
Krótki kod, długa lista przypadków wyjątkowych
Poza kilkoma głównymi walutami wypisanymi w tablicy referencyjnej kryją się przypadki trudne. Waluty podlegają renowominacji – Zimbabwe pozbywało się zer wielokrotnie – a wycofane kody pozostają w rekordach historycznych. Niektóre terytoria używają wprost waluty innego kraju, więc nie posiadają lokalnego kodu. Kryptowaluty celowo wypadają poza ISO 4217 i używają własnych notowań, dlatego ledger obsługujący obie kategorie musi wiedzieć, w jakim obszarze nazw operuje. Kilka walut dzieli ponadto nazwę w różnych krajach, choć niesie różne kody i wartości. Praktycznym wnioskiem jest to, że kod jest stabilnym identyfikatorem, podczas gdy symbole, nazwy a nawet liczba miejsc dziesiętnych mogą się zmieniać.
Częste pytania
- Jaka waluta ma kod EUR?
- EUR to kod ISO 4217 euro, waluty większości krajów UE. Jego symbolem jest €.
- Jaki jest kod waluty Japonii?
- Japoński jen ma kod ISO 4217 JPY i symbol ¥. Nie ma miejsc po przecinku.
- Dlaczego zapisywać trzyliterowy kod zamiast symbolu?
- Symbole się powtarzają: $ może oznaczać USD, CAD, AUD i inne. Trzyliterowy kod ISO 4217 jest jednoznaczny.