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.