# Currency Amount (Zero-Decimal Currency)

Key: `finance.currency.amount_nodecimal`

Currency amounts for zero-decimal currencies (JPY, KRW, VND, CLP, ISK, HUF, and \~15 others). No fractional part. Comma thousands grouping with symbol prefix or suffix. broad\_type is INTEGER.

Page: <https://meridian.online/docs/projects/finetype/types/finance/currency/amount_nodecimal>

Samples: `¥1,234`, `₩10,000`, `¥100,000`, `₩1,234,567`

## Background

### Origin

ISO 4217 is a standard published by the International Organization for Standardization that defines alpha codes and numeric codes for currencies and gives information about the relationships between currencies and their minor units.[[1]](https://en.wikipedia.org/wiki/ISO_4217) The first edition of ISO 4217 was published in 1978.[[1]](https://en.wikipedia.org/wiki/ISO_4217) SIX is the official Maintenance Agency for the ISO 4217 currency codes, providing that service on behalf of ISO.[[2]](https://www.six-group.com/en/products-services/financial-information/market-reference-data/data-standards.html) The 2008 edition of ISO 4217 explains that a 0 in its Minor unit column means there is no minor unit for that currency, while 1, 2 and 3 signify ratios of 10:1, 100:1 and 1000:1.[[1]](https://en.wikipedia.org/wiki/ISO_4217)

Japan's New Currency Act of 1871 divided the yen decimally into 100 sen or 1,000 rin.[[3]](https://en.wikipedia.org/wiki/Japanese_yen) The sen and the rin were taken out of circulation at the end of 1953.[[3]](https://en.wikipedia.org/wiki/Japanese_yen) The South Korean won is technically divided into 100 jeon, but the jeon is no longer used for everyday transactions and appears only in foreign exchange rates.[[4]](https://en.wikipedia.org/wiki/South_Korean_won)

### Use

Java's Currency.getDefaultFractionDigits() returns the ISO 4217 minor unit, and its documentation gives 0 as the value for the Japanese Yen.[[5]](https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Currency.html) Unicode CLDR records for each currency the number of decimal digits normally formatted, with a default of 2.[[6]](https://www.unicode.org/reports/tr35/tr35-numbers.html) The LDML specification says CLDR's digits value is based on the ISO 4217 minor unit but may deviate from ISO 4217 where there is compelling evidence for different customary practice.[[6]](https://www.unicode.org/reports/tr35/tr35-numbers.html)

Stripe says ISK transitioned to a zero-decimal currency but, for backward compatibility, must be sent as a two-decimal value whose decimal part is always 00.[[7]](https://docs.stripe.com/currencies)

The ¥ sign represents both the Japanese yen and the Chinese yuan when writing in the Latin script.[[8]](https://en.wikipedia.org/wiki/Yen_and_yuan_sign) The yen and yuan sign is usually placed before the value, and is written JP¥50 or CN¥50 when disambiguation is needed.[[8]](https://en.wikipedia.org/wiki/Yen_and_yuan_sign) Many early systems reassigned code point 5C, the backslash in US-ASCII, to the yen sign, because 7-bit US-ASCII had no code point for ¥.[[8]](https://en.wikipedia.org/wiki/Yen_and_yuan_sign) Treat a bare ¥ as ambiguous: look for a currency code, a country column or decimals elsewhere in the column before assuming the amounts are yen. (Meridian's view) A value with a decimal point, such as ¥1,234.50, suggests the column is not yen-only, or that the source formats every currency with two decimals. (Meridian's view) Strip the symbol and the grouping commas and cast what is left to an integer, keeping the symbol or a currency code in its own column so the amount does not lose its currency. (Meridian's view)

## Sources

1. [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) — secondary source
2. [Financial Data Standards](https://www.six-group.com/en/products-services/financial-information/market-reference-data/data-standards.html) — organisation
3. [Japanese yen](https://en.wikipedia.org/wiki/Japanese_yen) — secondary source
4. [South Korean won](https://en.wikipedia.org/wiki/South_Korean_won) — secondary source
5. [Currency (Java SE 21 \& JDK 21)](https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/util/Currency.html) — documentation
6. [Unicode Locale Data Markup Language (LDML) Part 3: Numbers](https://www.unicode.org/reports/tr35/tr35-numbers.html) — standard
7. [Supported currencies](https://docs.stripe.com/currencies) — documentation
8. [Yen and yuan sign](https://en.wikipedia.org/wiki/Yen_and_yuan_sign) — secondary source