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

Google Sheets 提供 GOOGLEFINANCE 查询汇率,快速换算时够用。问题在于来源:它是一个无法查验、也无法选择的匿名市场综合价。Frankfurter 综合的是可查验的中央银行汇率;当数据源必须精确时,你可以固定使用某一家权威机构:用于欧盟增值税的欧洲央行参考汇率、波兰的 NBP 或巴西的 PTAX。固定数据源的历史数据与其发布内容保持一致。下面的公式可以用在任何原本使用 GOOGLEFINANCE 的地方。

快速开始

无需设置,也无需 API 密钥。用 IMPORTDATA 和 CSV 端点,把最新汇率放进单元格:

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

Sheets 会填入一个小型 date,base,quote,rate 表格。date 列会显示为序列号,选中该列后选择格式 > 数字 > 日期即可显示为日期。用逗号分隔,即可一次请求多种目标货币:

=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?base=usd&quotes=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&quotes=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&quotes=gbp&providers=bbk&group=month")

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