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

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

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

目標

  • スクリプトをセットアップします。
  • スクリプトを実行します。

Prerequisites

このサンプルを使用するには、次の前提条件が必要です。

  • Google アカウント(Google Workspace アカウントでは管理者の承認が必要になることがあります)。
  • インターネットにアクセスできるウェブブラウザ

スクリプトを設定する

  1. 新しいスプレッドシートを作成します。
  2. 新しいスプレッドシートで、メニュー項目の [拡張機能] > [Apps Script] を選択します。
  3. スクリプト エディタ内のコードをすべて削除して、以下のコードを貼り付けます。[保存のアイコン を保存] をクリックします。

    /**
     * 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);
    }
    

スクリプトを実行する

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

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

次のステップ

Apps Script でスプレッドシートを拡張する方法をさらに詳しく確認するには、次のリソースをご覧ください。