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 を使用してスプレッドシートを拡張する方法については、以下のリソースをご覧ください。