货币代码对照表

常见货币的 ISO 4217 三位代码、符号与所属地区对照,覆盖人民币、美元、欧元、日元、英镑等主要货币。

原理解析

ISO 4217 用三位字母(USD、CNY、EUR、JPY)加三位数字代码标识货币,避免「元/圆/円」等汉字同名造成的歧义。汇率由外汇市场实时浮动,同一代码在不同时刻价值不同。

货币符号(¥、$、€)并不唯一——¥ 既指人民币也指日元,$ 被多国使用。因此机器与跨境结算一律用 ISO 4217 代码而非符号;JPY 等货币无小数位也是常见的本地化坑。

什么时候该查这张表

这张表在你要把金额从一种货币换到另一种、或确认某个符号对应哪套代码时有用。ISO 4217 的关键点是:它定义了货币代码与小数位,不定义汇率。汇率是随时间变动的市场数据,与代码表完全无关。

不该查的情况:你在做金额计算或汇率换算。查到了 CNY 不代表你知道了该用哪个时点的汇率——汇率需要接实时数据源或定期同步,并把时间戳一起存下来,否则历史订单无法复算。

判断标准:需要「代码、符号、小数位」查本表;需要「现在 100 块值多少」必须接汇率 API。用静态汇率表做换算,得到的数字在几天后就是错的,而且往往很难被发现。

特别注意小数位:JPY 与 KRW 是 0 位小数,CNY 是 2 位,BHD/KWD/JOD/TND 是 3 位。用统一的 2 位逻辑处理全表会产生系统性错误,而且这些错误金额在账务上往往仍然"看起来合理"。

边界与常见陷阱

  • 货币代码不等于国家代码,也不等于符号

    多个国家共用一种货币(欧元 39 个国家使用 EUR,美元 广泛使用 USD),同一国家也可能流通多种货币。符号本身高度不唯一:$ 可能是 USD、CAD、AUD、HKD 或几十种其他货币。因此处理金额必须以 ISO 代码为键,符号仅作展示;用符号做键的系统在处理多币种报表时必然出错。

  • 小数位与舍入方式必须显式约定

    取整时必须先确定在哪一步、按什么方向舍入:先按汇率换算再舍入,与先舍入再换算,结果可能差一个最小单位。发票与账务通常要求在每一笔计算后立即舍入到该货币的小数位,并把舍入模式(向上、向下、四舍五入、银行家舍入)写进契约,否则不同系统算出的合计对不上。

  • 历史代码与已退出货币仍在使用

    代码废止不等于数据消失:老系统中仍存在已停用的代码(如 CUC 古巴比索、VEB 委内瑞拉 bolívar、以及欧元区之前的各成员国货币如 DEM、FRF)。处理历史财务数据、外部接口或迁移老库时,应识别这些代码并按明确规则处理,而不是当未知值丢弃——直接丢弃会造成对账断裂。

与相邻内容的分工

要查国家与地区标识(ISO 3166-1),用站内「国家代码」页;货币代码与国家代码有关联但独立,不能互相推导。

要查符号、名称与汇率,用专门的外汇数据源或货币 API;本表只提供代码与小数位,不含汇率。

处理金额格式化(符号位置、千分位、小数位)属于 i18n 范畴,用 Intl.NumberFormat 配合货币代码即可,不要手工拼接。

涉及跨境税务与合规判断时,本表不提供任何规则依据,应查各法域的官方规定。

实战片段

要点:① 金额格式化交给 Intl.NumberFormat,它按币种自动取小数位(JPY 0 位、CNY 2 位、BHD 3 位)并处理符号位置,手工拼接必然漏掉零小数位币种;② 汇率必须带 asOf 时间戳并与金额一同存储,否则历史订单无法复算;③ 舍入要在每一步立即执行并明确模式(此处用 half-up),先换算后舍入与先舍入后换算可能差一个最小单位。

// 用 Intl.NumberFormat 处理金额,别手工拼符号
const amount = 1234567.891

// ① 按币种自动取小数位(JPY=0、CNY=2、BHD=3)与符号
new Intl.NumberFormat('zh-CN', {
  style: 'currency',
  currency: 'CNY',
}).format(amount)                        // ¥1,234,567.89

new Intl.NumberFormat('ja-JP', {
  style: 'currency',
  currency: 'JPY',
}).format(amount)                        // ¥1,234,568 —— 0 位小数自动生效

// ② 换算必须带时点,并把 timestamp 一起存,否则历史无法复算
type RateSnapshot = { base: string; rates: Record<string, number>; asOf: string }

async function convert(
  amount: number,
  from: string,
  to: string,
  snapshot: RateSnapshot,
): Promise<number> {
  if (from === to) return amount
  const rate = snapshot.rates[to] / snapshot.rates[from]
  const converted = amount * rate
  // 关键:按目标币种小数位舍入;toFixed 是二进制近似,记账请改用最小单位整数
  const dp = new Intl.NumberFormat('en', {
    style: 'currency',
    currency: to,
  }).resolvedOptions().maximumFractionDigits
  return Number(converted.toFixed(dp))
}

// ③ 恒定式金额只做展示换算,记账用原币种 + 快照汇率
// 存储:{ amount: 1234.56, currency: 'USD', rateToBase: 7.1234, asOf: '2026-01-15' }
// 展示时按 asOf 选快照,不按「今天的汇率」回算历史账目

实践注解

  • 货币没有「浮点数」这个选项0.1 + 0.2 !== 0.3 在金额上不可接受。金额必须以最小货币单位(分)的整数存储与运算,只在展示层格式化;小数位不是统一的 2(日元 0 位、第纳尔 3 位),硬编码两位会算错。
  • 货币代码用 ISO 4217 三位字母,符号会重复$ 同时是美元、加元、澳元、港元的符号,¥ 同时是人民币与日元。接口与数据库一律存代码(CNY/USD/JPY),符号只在渲染时按 locale 映射,否则跨币种会串账。
  • 汇率换算必须带时间戳与方向汇率是「某一时刻」的比值,且 A→B 与 B→A 存在买卖价差。财务口径要求记录生效时间与来源,直接用当前汇率回算历史金额会造成对不上账。

数据来源

  • ISO 4217 (currency codes and minor units)

上述编号、名称与定义均来自公开规范,本站不主张对规范数据本身的独创性;本页的编排方式、中文释义与实践注解由本站撰写。

货币ISO 4217符号地区
人民币CNY¥中国
港元HKDHK$中国香港
澳门元MOPMOP$中国澳门
美元USD$美国
欧元EUR€欧元区
日元JPY¥日本
英镑GBP£英国
韩元KRW₩韩国
俄罗斯卢布RUB₽俄罗斯
加元CADC$加拿大
澳元AUDA$澳大利亚
瑞士法郎CHFFr瑞士
印度卢比INR₹印度
巴西雷亚尔BRLR$巴西
新加坡元SGDS$新加坡

常见问题

ISO 4217 货币代码的三位是怎么定的?

通常由「国家两字母代码 + 货币首字母」构成,例如 CN(中国)+ Y(元)→ CNY;USD 中 US 是美国、D 代表 Dollar。也有惯例例外(如英镑 GBP 源自历史名称)。数字码(如 156 人民币)则与字母无关。

¥ 同时是人民币和日元符号,如何区分?

两者确实共用 ¥。书面区分靠 ISO 代码:CNY(人民币)与 JPY(日元)。在 UI 中建议同时展示代码或本地化符号(如人民币用 RMB、日元用 JP¥)以避免歧义。

为什么有的货币没有小数(如日元、韩元)?

货币最小通货单位不同:日元与韩元的最小单位是「元/圆」本身,无分币,故小数位为 0;而人民币、美元有角分,小数位为 2。ISO 4217 的 minor unit 字段记录了这一点。

比特币(BTC)有 ISO 4217 货币代码吗?

没有官方 ISO 4217 代码。ISO 为比特币保留了 XBT 作为非官方/实验性代码(X 前缀表示非国家),但多数交易所仍用 BTC。黄金等大宗商品也不在 ISO 4217 内。