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 Script, вставьте этот код и сохраните:
/**
* 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. Польские НДС и налог на прибыль (CIT) пересчитывают по курсу NBP.
CNB- Фиксинг Чешского национального банка для чешского учёта и налогообложения.
BCB- PTAX Banco Central do Brasil, ориентир для бразильских контрактов и налогов.
BANXICO- Курс FIX Banco de México для расчётов по обязательствам в долларах США.
Посмотрите все источники. Закреплённый источник публикует данные по собственному расписанию, поэтому его последний курс может отставать от последнего сводного на день.
Исторические ряды
Используйте from для диапазона дат и group=month, чтобы свернуть его до одной строки в месяц, готовой для графика. Сводная история может немного меняться с поступлением новых данных, поэтому закрепляйте источник, когда значения должны оставаться неизменными.
=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?from=1949-12-01&base=usd"es=gbp&providers=bbk&group=month")
Этот запрос получает курс доллара США к фунту с 1949 года из архива Deutsche Bundesbank. Видно, как привязка фунта на уровне 2,80 доллара годами держалась неизменной, а в 1967 году сломалась. Глубокая история опирается на франкфуртские фиксинги Бундесбанка: доллар к марке с 1948 года, большинство других кроссов доллара с 1949 по 1970 год. С 1999 года эстафету принимает Европейский центральный банк, поэтому непрерывный современный ряд даёт сводный курс по умолчанию или providers=ecb.