Währungs- & EinheitenumrechnungReferenz
Währungen & Einheiten umrechnen. Eine calc-Regel rechnet einen Betrag in eine andere Währung oder eine Menge in eine andere Einheit um und speichert das Ergebnis. Schreiben Sie die Umrechnung in die Spalte Value — das Zielfeld wird schreibgeschützt und bei jedem Speichern neu berechnet (und aktualisiert sich live während der Eingabe). Vier Funktionen stehen zur Verfügung — zwei, die Umrechnungstabellen in Ihrer eigenen Arbeitsmappe lesen, und zwei, die gar keine Tabellen benötigen:
| Funktion | Was sie tut |
|---|---|
currency_conversion(amount, from, to) | Rechnet den Betrag mit der Exchange Rates-Tabelle Ihrer Arbeitsmappe um. |
unit_conversion(quantity, from, to) | Rechnet die Menge mit der Unit Conversions-Tabelle Ihrer Arbeitsmappe um. |
currency_conversion_api(amount, from, to, date) | Rechnet mit Live-Wechselkursen um — keine Tabelle nötig. Das date ist optional (siehe unten). |
unit_conversion_api(quantity, from, to) | Rechnet mit der eingebauten Einheitentabelle von SheetApps um — keine Tabelle nötig. |
Die Argumente. Jede Funktion nimmt zuerst den umzurechnenden Wert — das Geld- oder Mengenfeld —, dann die Codes from und to; currency_conversion_api nimmt ein optionales viertes Argument, das date. Ein leerer Wert bleibt leer (nie 0), und das Ergebnis trägt immer den Ziel-Code — ein Literal "EUR" legt das Feld auf Euro fest, am Bildschirm und im Export.
Die Codes können fest oder pro Datensatz sein. Schreiben Sie from und to als festen Code in Anführungszeichen ("EUR") oder als Feldnamen (currency), damit jeder Datensatz aus seiner eigenen Währung oder Einheit umrechnet — z. B. wandelt currency_conversion(total_amount, currency, "EUR") die Summe jeder Bestellung in Euro um. Sie können auch um eine Umrechnung herum rechnen (… * 1.02).
Tabellenumrechnungen lesen zwei reservierte Nachschlageblätter: Exchange Rates mit den Spalten From · To · Rate und Unit Conversions mit From · To · Factor. SheetApps verwendet das genaue Paar, seine Umkehrung oder ×1 für denselben Code; fehlt das Paar, wird das Speichern blockiert und Ihnen mitgeteilt, welches Paar zu ergänzen ist. Bearbeiten Sie diese Tabellen jederzeit unter Stammdaten — kein erneutes Hochladen nötig.
API-Umrechnungen brauchen keine Tabellen. currency_conversion_api bezieht Live-Referenzkurse der Europäischen Zentralbank vom kostenlosen, schlüssellosen Dienst Frankfurter (frankfurter.dev): Übergeben Sie ein date (ein Datumsfeld oder ein ISO-Datum wie "2026-07-01"), um zum Kurs dieses Tages umzurechnen, oder lassen Sie es weg für den heutigen. unit_conversion_api nutzt eine eingebaute Tabelle für gängige Einheiten von Masse, Länge, Fläche, Volumen, Temperatur und Zeit (UNECE-Codes und Alltagsnamen wie kg, lb, ft, °C). Beide funktionieren in veröffentlichten Bundles, sobald der ausführende Computer Internet hat.
currency_conversion_api kann ein Paar, das er nicht führt, nicht umrechnen und blockiert das Speichern mit einer Meldung, die das Paar nennt. Für jede nicht abgedeckte Währung nutzen Sie die tabellenbasierte currency_conversion und liefern den Kurs selbst: Fügen Sie die Zeile From · To · Rate in Ihr Exchange Rates-Blatt ein oder pflegen Sie sie in den Stammdaten der App.Total EUR ist immer €, egal in welcher Währung die Bestellung erfasst wurde. Kann ein Live-Kurs nicht abgerufen werden und ist keiner zwischengespeichert, wird das Speichern blockiert, bis der Kursdienst erreichbar ist; ein fehlendes Tabellenpaar blockiert das Speichern ebenso.