カスタム関数のクイックスタート

Google Apps Script を使用してカスタム関数を作成すると、組み込み関数と同じように Google スプレッドシートで使用できます。

次のクイックスタートサンプルでは、割引アイテムのセール価格を計算するカスタム関数を作成します。セール価格は米ドルで表示されます。

目標

スクリプトを設定します。
スクリプトを実行します。

Prerequisites

このサンプルを使用するには、次の前提条件を満たす必要があります。

Google アカウント（Google Workspace アカウントの場合、管理者の承認が必要になる場合があります）。
インターネットにアクセスできるウェブブラウザ。

スクリプトを設定する

新しいスプレッドシートを作成します。
新しいスプレッドシートで、メニュー項目 [拡張機能] > [Apps Script] を選択します。

スクリプトエディタ内のコードをすべて削除し、以下のコードを貼り付けます。[ を保存] をクリックします。

/**
 * Calculates the sale price of a value at a given discount.
 * The sale price is formatted as US dollars.
 *
 * @param {number} input The value to discount.
 * @param {number} discount The discount to apply, such as .5 or 50%.
 * @return The sale price formatted as USD.
 * @customfunction
 */
function salePrice(input, discount) {
  let price = input - (input * discount);
  let dollarUS = Intl.NumberFormat("en-US", {
    style: "currency",
    currency: "USD",
});
  return dollarUS.format(price);
}

スクリプトを実行する

スプレッドシートに戻ります。
セルに「=salePrice(100,.2)」と入力します。最初のパラメータは元の価格を表し、2 番目のパラメータは割引率を表します。小数点のカンマを使用するロケーションでは、代わりに「=salePrice(100;0,2)」の入力が必要になる場合があります。

セルに入力した数式により、前のセクションで作成したスクリプトで関数が実行されます。この関数により、セール価格は $80.00 となります。

次のステップ

Apps Script を使用してスプレッドシートを拡張する方法については、以下のリソースをご覧ください。