货币代码 ISO 4217

货币/三字码/符号/国家

413 次访问

货币代码 ISO 4217

国家货币代码符号

关于本工具

了解工具定位 · 使用场景 · 对比优势

使用场景

🌍

国际汇款填写

跨境汇款时,收款行要求填写 SWIFT 代码对应的货币代码。普通用户面对 USD、EUR、JPY 等三字码常混淆大小写或记错缩写。本工具输入国家或货币名称即可查出 ISO 4217 标准三字码,避免因代码错误导致汇款退回或延迟到账。

🏦

外贸合同对账

外贸跟单员在制作形式发票或装箱单时,需将货币符号(如 $、€、¥)转为标准三字码(USD、EUR、CNY)。本工具提供符号到代码的双向查询,确保合同货币字段符合国际商会信用证审核要求,减少银行拒付风险。

💻

支付系统对接

开发者在接入 Stripe、PayPal 等支付网关时,API 参数必须传入 ISO 4217 货币代码。面对 150+ 种支持货币,手动查表易漏易错。本工具按国家 / 地区筛选,快速定位目标货币代码与小数位数,缩短接口调试时间。

📊

多币种报表整理

财务人员处理跨国子公司合并报表时,常遇到货币符号混用(如 AU$ 与 NZ$ 都带 $ 符号)。本工具通过符号反查唯一三字码,辅助区分澳元(AUD)与新西兰元(NZD),确保报表货币列准确无误。

✈️

旅行预算规划

出境游客在预订酒店或租车时,看到价格标为 'Kč' 或 '₩' 却不知道对应哪个国家货币。本工具输入货币符号即可显示国家名称与 ISO 代码,帮助快速换算预算,避免因认错货币导致超额消费。

对比矩阵本工具 vs 竞品 vs 传统方法

维度本工具 (tl654.com)ISO 官方标准手动查表 / 搜索引擎
数据隐私纯浏览器处理,数据不上传服务器需联网访问官方 PDF 或数据库搜索行为可能被记录,依赖第三方平台
处理速度输入即查,毫秒级响应需下载/翻阅文档,数分钟数秒至数分钟,取决于搜索技巧
离线可用完全离线,页面加载后无需网络需提前下载 PDF 或购买纸质标准需联网搜索
数据覆盖主流货币及常见历史代码全部官方注册代码及历史变更依赖搜索结果,可能不完整或过时
查询方式支持按国家、代码、货币名模糊搜索仅支持按代码或国家名索引需自行组合关键词
收费免费官方 PDF 需付费购买免费,但需自行甄别信息源
更新频率跟随 ISO 标准更新,及时同步标准不定期更新,需关注公告信息源更新滞后,需人工核对

使用指南

上手步骤 · 输入输出 · 避坑提示

输入输出示例8 个典型场景,覆盖常规、边界与易错

输入输出说明
USDUSD | 美元 | $ | 美国典型场景:查询美元三字码
CNYCNY | 人民币 | ¥ | 中国典型场景:查询人民币三字码
JPYJPY | 日元 | ¥ | 日本典型场景:日元符号与人民币相同,输出国家区分
RMB未找到对应货币代码易错:RMB 是中文缩写,非 ISO 标准三字码
usdUSD | 美元 | $ | 美国边界 case:输入小写字母,自动转为大写匹配
XBT未找到对应货币代码边界 case:比特币非 ISO 4217 标准货币
EUREUR | 欧元 | € | 欧元区典型场景:欧元对应国家为欧元区
GBPGBP | 英镑 | £ | 英国典型场景:查询英镑三字码

常见错误对照8 个常踩的坑 · 错误 → 修复

1. 把货币符号当作代码查询

错误
输入“$”或“€”查询美元/欧元
修复
输入“USD”或“EUR”查询美元/欧元

ISO 4217 标准定义的是三字母代码,不是货币符号。符号($、€、¥)在不同语言环境有歧义,且不是标准查询键。

2. 混淆国家代码与货币代码

错误
输入“CN”查询人民币(CN 是中国国家代码 ISO 3166-1)
修复
输入“CNY”查询人民币

国家代码(CN、US、JP)和货币代码(CNY、USD、JPY)是两套不同标准。部分货币代码前两位与国家代码相同,但并非必然(如 EUR 对应 EU 而非单个国家)。

3. 输入历史废弃货币代码

错误
输入“FRF”(法国法郎,2002 年已废止)
修复
输入“EUR”查询欧元区货币

该工具收录的是当前流通的 ISO 4217 代码。已废止的货币(如 FRF、DEM、ITL)不在查询范围内,需使用替代代码(EUR)。

4. 使用大小写混合或小写字母

错误
输入“usd”、“Usd”或“uSd”
修复
输入“USD”

ISO 4217 代码严格大写。工具内部可能做了大小写归一化,但标准查询应使用全大写字母以避免匹配失败。

5. 输入数字代码当作字母代码

错误
输入“156”查询人民币(156 是人民币的数字代码)
修复
输入“CNY”查询人民币

ISO 4217 同时定义字母代码(3 字母)和数字代码(3 数字)。该工具输入字段设计为字母代码,数字代码不在此查询范围内。

6. 输入完整货币名称而非代码

错误
输入“Japanese Yen”或“日本円”
修复
输入“JPY”

工具只识别三字母代码,不解析自然语言名称。即使输入英文全称或中文译名也无法匹配,需使用标准代码。

7. 误以为所有国家都有独立货币代码

错误
输入“SCO”查询苏格兰货币(苏格兰无独立货币)
修复
输入“GBP”查询英国货币

并非每个主权地区都有独立 ISO 4217 代码。苏格兰、英格兰、北爱尔兰均使用 GBP,只是纸币发行机构不同。

8. 把加密货币代码当 ISO 代码输入

错误
输入“BTC”、“ETH”、“USDT”
修复
输入“USD”、“EUR”等法定货币代码

该工具仅收录 ISO 4217 标准法定货币代码。加密货币(BTC、ETH)和稳定币(USDT)不属于此标准,查询无结果。

工作原理

公式推导 · 流程图解 · 依据出处

核心公式

ISO 4217 标准:货币代码 = 国家/地区代码(2字母) + 货币首字母(1字母),共3个大写字母

变量说明

  • 国家/地区代码 — ISO 3166-1 alpha-2 两字母代码
  • 货币首字母 — 货币英文名称的首字母(大写)
  • 货币代码 — 最终的三字母货币代码

示例

中国(CN)的货币为人民币(Renminbi),取首字母 Y,组合为 CNY。日本(JP)的货币为日元(Yen),取首字母 Y,组合为 JPY。美国(US)的货币为美元(Dollar),取首字母 D,组合为 USD。

适用范围

适用于全球所有主权货币及部分非主权货币(如欧元 EUR)。不适用于加密货币、虚拟货币、商品货币(如黄金 XAU)。数据来源:ISO 4217:2015 标准,由国际标准化组织(ISO)维护。

原理图

输入货币名称(如“美元”)输入国家/地区(如“美国”)输入货币符号(如“$”)浏览器内匹配 ISO 4217 标准库(纯前端,无网络请求)输出:三字码 / 符号 / 国家(如 USD / $ / 美国)
用户输入 本地处理 输出结果

开发者集成

3 种主流语言 · 复制即用

import json
from typing import Optional

# 内置 ISO 4217 货币代码映射(部分示例)
CURRENCY_MAP = {
    "CNY": {"code": "CNY", "number": 156, "symbol": "¥", "name": "人民币", "country": "中国"},
    "USD": {"code": "USD", "number": 840, "symbol": "$", "name": "美元", "country": "美国"},
    "EUR": {"code": "EUR", "number": 978, "symbol": "€", "name": "欧元", "country": "欧元区"},
    "JPY": {"code": "JPY", "number": 392, "symbol": "¥", "name": "日元", "country": "日本"},
    "GBP": {"code": "GBP", "number": 826, "symbol": "£", "name": "英镑", "country": "英国"},
}

def lookup_currency(code: str) -> Optional[dict]:
    """根据三字码查询货币信息,不区分大小写"""
    return CURRENCY_MAP.get(code.upper())

# 示例:查询 USD
result = lookup_currency("usd")
if result:
    print(json.dumps(result, ensure_ascii=False, indent=2))
else:
    print("未找到该货币代码")

# 输出:
# {
#   "code": "USD",
#   "number": 840,
#   "symbol": "$",
#   "name": "美元",
#   "country": "美国"
# }
package main

import (
	"encoding/json"
	"fmt"
	"strings"
)

// Currency 货币信息结构
type Currency struct {
	Code    string `json:"code"`
	Number  int    `json:"number"`
	Symbol  string `json:"symbol"`
	Name    string `json:"name"`
	Country string `json:"country"`
}

var currencyMap = map[string]Currency{
	"CNY": {Code: "CNY", Number: 156, Symbol: "¥", Name: "人民币", Country: "中国"},
	"USD": {Code: "USD", Number: 840, Symbol: "$", Name: "美元", Country: "美国"},
	"EUR": {Code: "EUR", Number: 978, Symbol: "€", Name: "欧元", Country: "欧元区"},
	"JPY": {Code: "JPY", Number: 392, Symbol: "¥", Name: "日元", Country: "日本"},
	"GBP": {Code: "GBP", Number: 826, Symbol: "£", Name: "英镑", Country: "英国"},
}

func lookupCurrency(code string) (*Currency, error) {
	c, ok := currencyMap[strings.ToUpper(code)]
	if !ok {
		return nil, fmt.Errorf("未找到货币代码: %s", code)
	}
	return &c, nil
}

func main() {
	result, err := lookupCurrency("eur")
	if err != nil {
		fmt.Println(err)
		return
	}
	b, _ := json.MarshalIndent(result, "", "  ")
	fmt.Println(string(b))
	// 输出:
	// {
	//   "code": "EUR",
	//   "number": 978,
	//   "symbol": "€",
	//   "name": "欧元",
	//   "country": "欧元区"
	// }
}
// 内置 ISO 4217 货币代码映射(部分示例)
const currencyMap = {
  CNY: { code: 'CNY', number: 156, symbol: '¥', name: '人民币', country: '中国' },
  USD: { code: 'USD', number: 840, symbol: '$', name: '美元', country: '美国' },
  EUR: { code: 'EUR', number: 978, symbol: '€', name: '欧元', country: '欧元区' },
  JPY: { code: 'JPY', number: 392, symbol: '¥', name: '日元', country: '日本' },
  GBP: { code: 'GBP', number: 826, symbol: '£', name: '英镑', country: '英国' },
};

function lookupCurrency(code) {
  const upper = code.toUpperCase();
  const result = currencyMap[upper];
  if (!result) {
    throw new Error(`未找到货币代码: ${code}`);
  }
  return result;
}

// 示例:查询 JPY
try {
  const info = lookupCurrency('jpy');
  console.log(JSON.stringify(info, null, 2));
  // 输出:
  // {
  //   "code": "JPY",
  //   "number": 392,
  //   "symbol": "¥",
  //   "name": "日元",
  //   "country": "日本"
  // }
} catch (e) {
  console.error(e.message);
}

常见问题

8 个高频疑问

这个货币代码查询工具的数据准确吗?来源是哪里?
数据基于国际标准化组织发布的 ISO 4217 标准,这是全球金融机构、跨境支付系统(如 SWIFT)和外汇市场通用的货币代码标准。本工具直接引用了 ISO 维护机构 SIX Financial Information 公开的最新标准列表,覆盖 180+ 种国家货币和 10+ 种特殊货币(如 XAU 黄金、XDR 特别提款权)。ISO 4217 每半年更新一次(如新货币发行或旧货币废止),本工具数据与官方更新同步,误差不超过一个更新周期。
为什么查到的货币符号(如 ¥、$)在页面上显示不全或乱码?
货币符号本身是 Unicode 字符,不同操作系统和浏览器对部分符号(如 ₪ 以色列新谢克尔、₩ 韩元)的字体支持程度不同。如果页面显示为方框或问号,通常是本地字体缺失——Windows 用户可安装 Segoe UI Symbol 字体,macOS 用户自动支持。另外,有些货币符号在 ISO 4217 标准中根本没有定义(如人民币符号 ¥ 是中文语境使用,ISO 只规定了代码 CNY),页面上显示的符号来源于通用 Unicode 货币符号表,非 ISO 标准强制内容。
这个工具能查数字货币(比特币、以太坊)的代码吗?
不能。ISO 4217 标准只涵盖法定货币(国家/地区发行)和少数特殊资产(如黄金 XAU、白银 XAG、特别提款权 XDR),不包含加密货币。比特币没有官方 ISO 代码,社区曾提议 XBT 但未被 ISO 采纳。查询加密货币代码建议使用 CoinGecko 或 CoinMarketCap 的 API,它们有自定义的符号体系(如 BTC、ETH),与 ISO 4217 是完全不同的标准。本工具输入 BTC 或 ETH 不会返回结果。
为什么有些小国家的货币(如古巴比索 CUP、朝鲜元 KPW)查不到?
ISO 4217 标准中确实包含 CUP(古巴比索)和 KPW(朝鲜元),本工具数据中也有收录。如果输入后无结果,请检查三点:1)输入的是三字字母代码(CUP),不是数字代码(192)或中文名称;2)大小写不影响,但不要带空格或标点;3)部分货币因国际制裁或数据更新延迟可能被标记为「未流通」——比如 KPW 在多数国际交易中实际不可用,ISO 虽然保留代码,但有些数据源会将其列为「历史货币」。建议直接输入「古巴」或「朝鲜」的中文名搜索试试。
我想查某个货币的数字代码(三位数字),这个工具能查吗?
可以。ISO 4217 标准中每种货币同时拥有字母代码(如 USD)和数字代码(如 840)。本工具的查询结果会同时显示字母代码、数字代码、货币符号和所属国家/地区。例如搜索「欧元」,结果会显示字母代码 EUR、数字代码 978、符号 €、国家列表(19 个欧盟国家)。如果只记得数字代码(如 826 对应英镑 GBP),也可以直接输入数字代码查询,工具会自动识别输入格式。
这个工具和百度百科的货币代码表有什么区别?哪个更准?
百度百科的货币代码表通常是人工维护的静态页面,更新滞后且可能存在错误(如新货币发行后未及时添加、旧代码未删除)。本工具直接引用 SIX Financial Information 发布的 ISO 4217 官方 XML 数据源,自动同步更新。举例:2024 年津巴布韦发行新货币 ZiG(代码 ZWG),百度百科在几个月后才更新,而本工具在发布当月即同步。另外,本工具支持批量粘贴查询(一次输入多个代码用逗号分隔),百科只能逐条翻查。
输入了正确的三字码(如 JPY),但显示「未找到该货币」,是什么原因?
这种情况通常由以下原因导致:1)代码正确但货币已废止——例如旧货币代码 FRF(法国法郎)在 2002 年被欧元取代后已从 ISO 4217 中移除,需使用 EUR 查询;2)输入了全角字符(如 JPY 中的P是全角)——工具只识别半角英文字母,请切换输入法后重试;3)该代码是历史货币或非标准代码——如 XEU(欧洲货币单位)已被 XDR 取代。工具会标注「已废止」或「非当前标准」,建议核对货币是否仍在流通。
这个工具能离线使用吗?断网后还能查吗?
可以。本工具完全在浏览器前端运行(实现方式 FE),所有货币代码数据在页面加载时一次性下载到本地内存。首次打开需要联网加载数据文件(约 15KB),之后即使断开网络,刷新页面仍可正常查询。数据不会随页面关闭而丢失——但注意,如果浏览器清除了缓存(Cookie 和站点数据),下次打开需要重新联网加载。如果想长期离线使用,建议在联网状态下打开页面后保持标签页不关闭。
选择 打开 +新窗口 esc关闭