基本例子

為避免電子表格中出現難看的 #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 工作表功能一樣使用它。

StackOverflow 文件

請注意在鍵入公式時,函式如何顯示在自動完成中。這是由於函式宣告上方的多行註釋,它用於描述函式與 JSDoc 和 Javadoc 類似的功能。要使公式顯示在自動完成中,必須在註釋中指定 @customfunction 標記。