google-apps-script
Googleスプレッドシート用のカスタム関数を作成する

前書き

標準重力カスタム定数

この関数は、指定された加速度単位で標準的な重力定数を返します（cm /s²の場合は1、ft /s²の場合は2、m /s²の場合は3）

/**
 * Returns the standard gravity constant in the specified acceleration units
 * Values taken from https://en.wikipedia.org/wiki/Standard_gravity on July 24, 2016.
 *
 * @param  {number}  input  1 for cm/s², 2 for ft/s², 3 for m/s²
 *
 * @customfunction
 */
function sg(units_key) {
  var value;
  switch(units_key) {
    case 1:
      value = 980.665;
      break;
    case 2:
      value = 32.1740;
      break;
    case 3:
      value = 9.80665;
      break;
    default:
      throw new Error('Must to specify 1, 2 or 3');
  }
  return value;
}

この機能を使用するには、スクリプトエディタ（ツール - >スクリプトエディタ...）を使用してスプレッドシートにバインドする必要があります。関数が追加されると、セルの式で関数を呼び出すことによって、他のGoogleシート関数と同様に使用できます。

数式に入力すると、関数がオートコンプリートでどのように表示されるかに注意してください。これは、関数がJSDocおよびJavadocに似ていることを記述するために使用される、関数宣言の上の複数行のコメントによるものです。オートコンプリートで数式を表示するには、コメントに@customfunctionタグを指定する必要があります。

基本的な例

スプレッドシートで見苦しい#DIV/0エラーを回避するために、カスタム関数を使用することができます。

/**
 * Divides n by d unless d is zero, in which case, it returns
 * the given symbol.
 *
 * @param  {n}  number The numerator
 * @param  {d}  number The divisor
 * @param  {symbol}  string The symbol to display if `d == 0`
 * @return {number or string} The result of division or the given symbol
 *
 * @customfunction
 */
function zeroSafeDivide(n, d, symbol) {  
  if (d == 0)
    return symbol;
  else
    return n / d;
}

この機能を使用するには、スクリプトエディタ（ ツール - >スクリプトエディタ... ）を使用してスプレッドシートにバインドする必要があります。関数が追加されると、セルの式で関数を呼び出すことによって、他のGoogleシート関数と同様に使用できます。

数式に入力すると、関数がオートコンプリートでどのように表示されるかに注意してください。これは、関数がJSDocおよびJavadocに似ていることを記述するために使用される、関数宣言の上の複数行のコメントによるものです。オートコンプリートで数式を表示するには、コメントに@customfunctionタグを指定する必要があります。