google-apps-script
Maak een aangepaste functie voor Google Spreadsheets

Invoering

Standaard zwaartekracht aangepaste constante

Deze functie retourneert de standaardzwaartekrachtconstante in de opgegeven versnellingseenheden (1 voor cm / s², 2 voor ft / s², 3 voor 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;
}

Om de functie te gebruiken, moet deze worden gebonden aan een spreadsheet met behulp van de scripteditor (Extra -> Scripteditor ...). Zodra de functie is toegevoegd, kan deze worden gebruikt als elke andere functie voor Google-bladen door de functie in de formule van een cel aan te roepen.

Merk op hoe de functie wordt weergegeven in automatisch aanvullen wanneer deze in een formule wordt getypt. Dit komt door de opmerking met meerdere regels boven de functieverklaring die wordt gebruikt om te beschrijven wat de functie doet vergelijkbaar met JSDoc en Javadoc. Als u de formule automatisch wilt laten weergeven, moet de tag @customfunction worden opgegeven in de opmerking.

Basis voorbeeld

Om lelijke #DIV/0 fouten in een spreadsheet te voorkomen, kan een aangepaste functie worden gebruikt.

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

Om de functie te gebruiken, moet deze worden gebonden aan een spreadsheet met behulp van de scripteditor ( Extra -> Scripteditor ... ). Zodra de functie is toegevoegd, kan deze worden gebruikt als elke andere functie voor Google-bladen door de functie in de formule van een cel aan te roepen.

Merk op hoe de functie wordt weergegeven in automatisch aanvullen wanneer deze in een formule wordt getypt. Dit komt door de opmerking met meerdere regels boven de functieverklaring die wordt gebruikt om te beschrijven wat de functie doet vergelijkbaar met JSDoc en Javadoc. Als u de formule automatisch wilt laten weergeven, moet de tag @customfunction worden opgegeven in de opmerking.