google-apps-script
Erstellen Sie eine benutzerdefinierte Funktion für Google Sheets

Einführung

Standardmäßige Schwerkraftkonstante

Diese Funktion gibt die Standardschwerkraftkonstante in den angegebenen Beschleunigungseinheiten zurück (1 für cm / s², 2 für ft / s², 3 für m / s²).

/**
 * 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;
}

Um die Funktion verwenden zu können, muss sie mit dem Skript-Editor (Extras -> Skript-Editor ...) an eine Tabelle gebunden werden. Nachdem die Funktion hinzugefügt wurde, kann sie wie jede andere Google-Tabellenfunktion verwendet werden, indem die Funktion in der Formel einer Zelle aufgerufen wird.

Beachten Sie, wie die Funktion bei der automatischen Eingabe in eine Formel angezeigt wird. Dies ist auf den mehrzeiligen Kommentar über der Funktionsdeklaration zurückzuführen, mit dem beschrieben wird, was die Funktion ähnlich wie JSDoc und Javadoc macht. Damit die Formel in Autocomplete angezeigt wird, muss das @customfunction-Tag im Kommentar angegeben werden.

Basisbeispiel

Um unschöne #DIV/0 Fehler in einer Kalkulationstabelle zu vermeiden, kann eine benutzerdefinierte Funktion verwendet werden.

/**
 * 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;
}

Um die Funktion verwenden zu können, muss sie mit dem Skript-Editor ( Extras -> Skript-Editor ... ) an eine Tabelle gebunden werden. Nachdem die Funktion hinzugefügt wurde, kann sie wie jede andere Google-Tabellenfunktion verwendet werden, indem die Funktion in der Formel einer Zelle aufgerufen wird.

Beachten Sie, wie die Funktion bei der automatischen Eingabe in eine Formel angezeigt wird. Dies ist auf den mehrzeiligen Kommentar über der Funktionsdeklaration zurückzuführen, mit dem beschrieben wird, was die Funktion ähnlich wie JSDoc und Javadoc macht. Damit die Formel in Autocomplete @customfunction muss das @customfunction Tag im Kommentar angegeben werden.