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

コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

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

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

始める前に

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

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

設定する

  1. 新しいスプレッドシートを作成します。
  2. 新しいスプレッドシートで、メニュー項目から [Extensions] > [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);
    }
    
  4. 上部の [ を保存] をクリックします。

試してみる

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

この関数では、セール価格 $80.00 となります。

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