יש שאלות או בעיות? כתבו ב-GitHub Discussions.

ל-Google Sheets יש את GOOGLEFINANCE לשערי חליפין, ולהמרה מהירה היא בסדר. הבעיה היא המקור: שקלול שוק אלמוני שאי אפשר לבדוק או לבחור. Frankfurter משקלל שערים של בנקים מרכזיים באופן שאפשר לבדוק, וכשהמקור חייב להיות מדויק אפשר לקבע רשות אחת: שער הייחוס של ה-ECB למע"מ באיחוד האירופי, ה-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 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&quotes=eur&providers=ecb")
ECB
שער הייחוס של הבנק המרכזי האירופי, הסטנדרט למע"מ ולמכס באיחוד האירופי.
NBP
Narodowy Bank Polski. מע"מ ומס חברות בפולין מומרים לפי שער ה-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&quotes=gbp&providers=bbk&group=month")

השאילתה מושכת את הדולר האמריקאי מול הליש"ט עד 1949 מהארכיון של Deutsche Bundesbank. אפשר לראות את הצמדת ה-cable על $2.80 נשארת יציבה במשך שנים, ואז נשברת ב-1967. ההיסטוריה העמוקה עוברת דרך הפיקסינג של הבונדסבנק בפרנקפורט: הדולר מול המארק מ-1948, ורוב צמדי הדולר האחרים מ-1949 עד 1970. הבנק המרכזי האירופי לוקח את המושכות מ-1999, כך שסדרה מודרנית רציפה משתמשת בשקלול ברירת המחדל או ב-providers=ecb.