Sorun veya soruların için GitHub Discussions'a yaz.

Google Sheets zaten GOOGLEFINANCE fonksiyonuna sahiptir ve hızlı bir dönüşüm için her iki yöntem de çalışır. İkisi de harmanlanmış bir piyasa kuru sunar ve aşağıdaki formüller GOOGLEFINANCE koyduğun her yere yerleştirilebilir. Aralarındaki fark kaynaktır. GOOGLEFINANCE harmanı isimsizdir ve içine ne girdiğini seçemezsin. Frankfurter'ın harmanı ise şeffaftır; kaynak kesin olmak zorunda olduğunda tek bir kurumu sabitleyebilirsin: AB KDV'si için AMB gösterge kuru, Polonya için NBP veya Brezilya için PTAX. Ayrıca sessizce değişmeyen geçmiş kurlara da erişirsin.

Hızlı Başlangıç

Kurulum ve API anahtarı gerekmez. IMPORTDATA ve CSV endpoint'i ile canlı bir kuru hücreye aktar:

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

Sheets küçük bir date,base,quote,rate tablosu doldurur. date sütunu bir seri numarası olarak gelir. Seçip Biçim, Sayı, Tarih yolunu izleyerek görünür hale getirebilirsin. Virgülle ayırarak aynı anda birden fazla hedef kur iste:

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

Bir Tutarı Dönüştür

IMPORTDATA dönüştürülmüş toplamı değil, kuru döndürür. Tutarını içe aktarılan kur hücresiyle çarp ya da temiz ve tek bir çağrı için aşağıdaki özel fonksiyonu kullan.

Özel Fonksiyon

Yeniden kullanılabilir bir =FRANKFURTER() fonksiyonu için kısa bir Apps Script ekle. E-tablonda Uzantılar, Apps Script yolunu aç, bunu yapıştır ve kaydet:

function FRANKFURTER(amount, from, to, date) {
  let url = `https://api.frankfurter.dev/v2/rate/${from}/${to}`;
  if (date) url += `?date=${Utilities.formatDate(date, "UTC", "yyyy-MM-dd")}`;
  const data = JSON.parse(UrlFetchApp.fetch(url).getContentText());
  return amount * data.rate;
}

Ardından herhangi bir hücreden çağır:

=FRANKFURTER(100, "usd", "eur")

Geçmiş bir kur için tarih ilet:

=FRANKFURTER(100, "usd", "eur", DATE(2020, 1, 2))

Resmi Bir Kaynağı Sabitle

Varsayılan olarak tüm kaynakların harmanını alırsın. Tek bir kurumu sabitlemek için providers parametresini ekle. Bu, vergi ve muhasebe açısından önemlidir: birçok ülke yabancı para tutarlarını dönüştürürken kendi merkez bankasının yayınladığı kuru şart koşar.

=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?base=usd&quotes=eur&providers=ecb")
ECB
Avrupa Merkez Bankası gösterge kuru, AB KDV ve gümrük standardı.
NBP
Narodowy Bank Polski. Polonya KDV ve kurumlar vergisi NBP kuruyla dönüştürülür.
CNB
Çek Ulusal Bankası sabitlemesi, Çek muhasebe ve vergisi için kullanılır.
BCB
Banco Central do Brasil PTAX, Brezilya sözleşmeleri ve vergisi için gösterge.
BANXICO
ABD doları yükümlülüklerini kapatmak için Banco de México FIX kuru.

Tüm kaynaklara göz at. Sabitlenen bir kaynak kendi yayın takvimini izler; bu nedenle en güncel kuru, harmanlanmış güncel kurun bir gün gerisinde kalabilir.

Geçmiş Zaman Serileri

Bir tarih aralığı için from ve grafik çizmeye hazır şekilde ayda bir satıra indirgemek için group=month parametresini kullan. Frankfurter'ın bir e-tablodaki yerini hak ettiği nokta burasıdır: sessizce revize edilmeyen uzun ve istikrarlı seriler.

=IMPORTDATA("https://api.frankfurter.dev/v2/rates.csv?from=1949-12-01&base=usd&quotes=gbp&providers=bbk&group=month")

Bu sorgu, Deutsche Bundesbank arşivinden ABD dolarının İngiliz sterlini karşısındaki kurunu 1949'a kadar çeker. 2,80 dolarlık sabit kurun yıllarca nasıl korunduğunu ve 1967'de nasıl kırıldığını görebilirsin. Derin geçmiş Bundesbank'ın Frankfurt sabitlemelerinden gelir: 1948'den itibaren mark karşısında dolar ve 1949'dan 1970'e kadar çoğu diğer dolar çaprazı. 1999'dan itibaren görevi Avrupa Merkez Bankası devralır; bu nedenle kesintisiz modern bir seri için varsayılan harman veya providers=ecb kullanılır.