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

Google Apps Script を使用すると、カスタム関数を作成して、 Google スプレッドシートは組み込み関数のようなものです。

次のクイックスタート サンプルでは、 割引価格。セール価格の形式は米ドルです。

目標

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

前提条件

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

• 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 です。

次のステップ

引き続き、Google スプレッドシートで Apps Script に 次のリソースをご覧ください。

• スプレッドシートのカスタム関数
• Google Workspace のカスタム メニュー
• Google スプレッドシートを拡張する