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

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,20)」と入力します。最初のパラメータは元の価格を表し、2 番目のパラメータは割引率を表します。 小数点にカンマを使用する地域の場合は、代わりに「=salePrice(100;20)」と入力する必要があります。

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

次のステップ

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