Google Sheets
Google Sheets 提供 GOOGLEFINANCE 查询汇率,快速换算时够用。问题在于来源:它是一个无法查验、也无法选择的匿名市场综合价。Frankfurter 综合的是可查验的中央银行汇率;当数据源必须精确时,你可以固定使用某一家权威机构:用于欧盟增值税的欧洲央行参考汇率、波兰的 NBP 或巴西的 PTAX。固定数据源的历史数据与其发布内容保持一致。下面的公式可以用在任何原本使用 GOOGLEFINANCE 的地方。
快速开始
无需设置,也无需 API 密钥。用 IMPORTDATA 和 CSV 端点,把最新汇率放进单元格:
=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?base=usd"es=eur")
Sheets 会填入一个小型 date,base,quote,rate 表格。date 列会显示为序列号,选中该列后选择格式 > 数字 > 日期即可显示为日期。用逗号分隔,即可一次请求多种目标货币:
=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?base=usd"es=eur,gbp,jpy")
换算金额
IMPORTDATA 返回的是汇率,而不是换算后的总额。将金额乘以导入的汇率单元格,或使用下面的自定义函数一次完成。
自定义函数
要获得可重复使用的 =FRANKFURTER() 函数,请添加一小段 Apps Script。在表格中打开扩展程序 > Apps 脚本,粘贴以下代码并保存:
/**
* Converts an amount between currencies, at today's rate or on a date.
* @customfunction
*/
function FRANKFURTER(amount, from, to, date) {
let url = `https://api.frankfurter.dev/v2/rate/${from}/${to}`;
if (date) {
const tz = SpreadsheetApp.getActive().getSpreadsheetTimeZone();
url += `?date=${Utilities.formatDate(date, tz, "yyyy-MM-dd")}`;
}
const data = JSON.parse(UrlFetchApp.fetch(url).getContentText());
return amount * data.rate;
}
然后在任意单元格中调用:
=FRANKFURTER(100, "usd", "eur")
传入日期即可获取历史汇率:
=FRANKFURTER(100, "usd", "eur", DATE(2020, 1, 2))
固定官方数据源
默认情况下,你获得的是综合所有数据源的汇率。添加 providers 即可固定使用单一权威机构。这对税务和会计很重要:许多国家要求在换算外币金额时使用本国中央银行公布的汇率。
=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?base=usd"es=eur&providers=ecb")
ECB- 欧洲中央银行参考汇率,欧盟增值税和海关的标准汇率。
NBP- Narodowy Bank Polski(波兰国家银行)。波兰的增值税和企业所得税按 NBP 汇率换算。
CNB- 捷克国家银行的定盘汇率,用于捷克的会计和税务。
BCB- 巴西中央银行的 PTAX 汇率,巴西合同和税务的基准。
BANXICO- 墨西哥银行的 FIX 汇率,用于结算美元债务。
浏览所有数据源。固定的数据源按自己的发布时间表更新,因此其最新汇率可能比综合汇率晚一天。
历史序列
用 from 指定日期范围,再用 group=month 将其压缩为每月一行,便于直接绘制图表。综合汇率的历史数据可能随新数据录入而略有变动,如果数字必须保持不变,请固定数据源。
=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?from=1949-12-01&base=usd"es=gbp&providers=bbk&group=month")
这会从德意志联邦银行的档案中取回自 1949 年以来美元兑英镑的汇率。你可以看到英镑兑 2.80 美元的固定汇率多年保持不变,直到 1967 年被打破。更早的历史来自德意志联邦银行的法兰克福定盘价:美元兑马克始于 1948 年,其他大多数美元交叉汇率覆盖 1949 年至 1970 年。欧洲中央银行的数据从 1999 年开始接续,因此连续的现代序列可使用默认综合汇率或 providers=ecb。