有疑问或遇到问题?欢迎在 GitHub Discussions 发帖。

Excel 自带的汇率方案是 Microsoft 365 中的“货币”数据类型:一种实时综合汇率,既不能固定到某个数据源,也无法获取历史数据。Frankfurter 的综合汇率可以查验来源;当数据源必须精确时,你可以固定使用某一家权威机构:用于欧盟增值税的欧洲央行参考汇率、波兰的 NBP 或巴西的 PTAX。固定数据源的历史数据与其发布内容保持一致。在 Windows 和 Mac 上都可以用 Power Query 完成导入,Windows 还可以用一行公式快速换算。

Power Query

这是 Windows 和 Mac 通用的主要方式。前往数据 > 自网站,粘贴 CSV 端点地址,载入 date,base,quote,rate 表格。之后可随时通过数据 > 全部刷新更新:

https://api.frankfurter.dev/v2/rates.csv?base=usd&quotes=eur

用逗号分隔,即可一次请求多种目标货币:

https://api.frankfurter.dev/v2/rates.csv?base=usd&quotes=eur,gbp,jpy

换算金额

Power Query 载入的是汇率,而不是换算后的总额。将金额乘以载入的汇率单元格即可。如果只想临时换算一次而不建立查询,Windows 版 Microsoft 365 可以直接在公式中调用 API。添加一个名为 FRANKFURTER 的命名函数(公式 > 名称管理器 > 新建),定义如下:

=LAMBDA(amount, from, to, [date], amount * NUMBERVALUE(TEXTBEFORE(TEXTAFTER(WEBSERVICE("https://api.frankfurter.dev/v2/rate/" & from & "/" & to & IF(ISOMITTED(date), "", "?date=" & YEAR(date) & "-" & TEXT(MONTH(date), "00") & "-" & TEXT(DAY(date), "00"))), """rate"":"), "}"), "."))

然后在任意单元格中调用:

=FRANKFURTER(100, "usd", "eur")

传入日期即可获取历史汇率:

=FRANKFURTER(100, "usd", "eur", DATE(2020, 1, 2))

WEBSERVICE 仅适用于 Windows。由于 Excel 公式没有 JSON 解析器,该函数直接从响应文本中读取汇率。NUMBERVALUE 显式指定了小数点,因此在使用逗号作为小数点的区域设置下也能正常工作。在 Mac 上,请改为与 Power Query 载入的汇率单元格相乘。

固定官方数据源

默认情况下,你获得的是综合所有数据源的汇率。在查询 URL 中添加 providers,即可固定使用单一权威机构。这对税务和会计很重要:许多国家要求在换算外币金额时使用本国中央银行公布的汇率。

https://api.frankfurter.dev/v2/rates.csv?base=usd&quotes=eur&providers=ecb
ECB
欧洲中央银行参考汇率,欧盟增值税和海关的标准汇率。
NBP
Narodowy Bank Polski(波兰国家银行)。波兰的增值税和企业所得税按 NBP 汇率换算。
CNB
捷克国家银行的定盘汇率,用于捷克的会计和税务。
BCB
巴西中央银行的 PTAX 汇率,巴西合同和税务的基准。
BANXICO
墨西哥银行的 FIX 汇率,用于结算美元债务。

浏览所有数据源。固定的数据源按自己的发布时间表更新,因此其最新汇率可能比综合汇率晚一天。

历史序列

用 from 指定日期范围,再用 group=month 将其压缩为每月一行,便于直接绘制图表。通过 Power Query 载入后,它会像其他查询一样刷新。综合汇率的历史数据可能随新数据录入而略有变动,如果数字必须保持不变,请固定数据源。

https://api.frankfurter.dev/v2/rates.csv?from=1949-12-01&base=usd&quotes=gbp&providers=bbk&group=month

这会从德意志联邦银行的档案中取回自 1949 年以来美元兑英镑的汇率。你可以看到英镑兑 2.80 美元的固定汇率多年保持不变,直到 1967 年被打破。更早的历史来自德意志联邦银行的法兰克福定盘价:美元兑马克始于 1948 年,其他大多数美元交叉汇率覆盖 1949 年至 1970 年。欧洲中央银行的数据从 1999 年开始接续,因此连续的现代序列可使用默认综合汇率或 providers=ecb。