通貨と単位の変換リファレンス
通貨や単位の計算はアプリに任せましょう。calc ルールは、金額を別の通貨に、数量を別の単位に変換して結果を保存します — 注文がドルで届いても、ユーロ建てのレポートは正しいままです。変換式は Value 列に書きます:対象フィールドは読み取り専用になり、入力中もライブで更新され、レコードを保存するたびに再計算されます。関数は 4 つあります — 2 つはワークブック内の変換テーブルを読み取り、残りの 2 つはテーブルを一切必要としません:
| 関数 | 働き |
|---|---|
currency_conversion(amount, from, to) | ワークブックの Exchange Rates テーブルを使って金額を変換します。 |
unit_conversion(quantity, from, to) | ワークブックの Unit Conversions テーブルを使って数量を変換します。 |
currency_conversion_api(amount, from, to, date) | ライブ為替レートで変換します — テーブルは不要です。date は省略できます(下記参照)。 |
unit_conversion_api(quantity, from, to) | Sheetward の組み込み単位テーブルで変換します — テーブルは不要です。 |
かっこの読み方。各関数は、まず変換する値 — 金額または数量のフィールド — を取り、続いて from と to のコードを取ります。currency_conversion_api は 4 つ目として日付も受け取れます。空欄の値は空欄のまま(0 にはなりません)で、結果には常に変換先のコードが付きます — 固定の "EUR" なら、画面でもエクスポートでもフィールドはユーロのままです。
コードは固定でも、レコードごとでも。from と to は、引用符で囲んだコード("EUR")でも、フィールド名(currency)でも書けます。フィールド名にすると、各レコードが自分の通貨や単位から変換されます — currency_conversion(total_amount, currency, "EUR") は、どの通貨で請求された注文でも、その合計をユーロに変換します。変換のまわりに計算を加えることもできます(例えば 2% の手数料なら … * 1.02)。
テーブル変換なら、レートを自分の手で管理できます。2 つの予約済みルックアップシートを読み取ります:From · To · Rate 列を持つ Exchange Rates と、From · To · Factor 列を持つ Unit Conversions です。Sheetward は、一致するペア、その逆方向、またはコードが同じ場合の ×1 を使います。ペアが見つからない場合は保存をブロックし、追加すべきペアを知らせます — 根拠のないレートで合計が計算されることは決してありません。テーブルはマスターデータでいつでも更新でき、再アップロードは不要です。
API 変換はテーブルをまったく必要としません。currency_conversion_api は、無料でキー不要の Frankfurter サービス(frankfurter.dev)が提供する欧州中央銀行のライブ参照レートを使います:date(日付フィールド、または "2026-07-01" のような日付)を渡すとその日の公表レートで変換し、省略すると当日のレートを使います。unit_conversion_api は、質量・長さ・面積・体積・温度・時間の一般的な単位 — UNECE コードや kg、lb、ft、°C といった日常的な名前 — を収めた組み込みテーブルを使います。どちらも、実行するコンピューターがインターネットに接続していれば、スタンドアロンアプリでも動作します。
currency_conversion_api はリストにないペアを変換できず、そのペア名を示すメッセージとともに保存をブロックします。対応していない通貨には、テーブル方式の currency_conversion を使ってレートを自分で用意してください — From · To · Rate の行を Exchange Rates シートに追加するか、アプリのマスターデータで最新に保ちます。Total EUR は常に € です。ライブレートを取得できず、キャッシュもない場合は、レートサービスに接続できるまで保存がブロックされます — 古い推定値がレコードに残ることはありません。テーブルのペアが欠けている場合も、同じように保存がブロックされます。| 使う関数 | レートの出どころ | 向いている場面 |
|---|---|---|
| currency_conversion | 自分の Exchange Rates シート | レートを自分で決めたいとき、またはライブフィードにない通貨のとき |
| unit_conversion | 自分の Unit Conversions シート | 係数が自社独自のとき — 箱あたりの個数、トラックあたりのパレット数など |
| currency_conversion_api | ECB のライブ参照レート(Frankfurter) | 主要通貨で、当日または過去の日付のレートを手間なく使いたいとき |
| unit_conversion_api | Sheetward の組み込み単位テーブル | 一般的な単位(kg、lb、ft、°C…)を設定なしで使いたいとき |