google-apps-script
Crea una funzione personalizzata per Fogli Google

introduzione

Costante personalizzata di gravità standard

Questa funzione restituisce la costante di gravità standard nelle unità di accelerazione specificate (1 per cm / s², 2 per ft / s², 3 per 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;
}

Per utilizzare la funzione, è necessario essere associato a un foglio di calcolo utilizzando l'editor di script (Strumenti -> Editor di script ...). Una volta aggiunta la funzione, può essere utilizzata come qualsiasi altra funzione di Google fogli chiamando la funzione nella formula di una cella.

Nota come la funzione si presenta in completamento automatico quando viene digitata in una formula. Ciò è dovuto al commento a più righe sopra la dichiarazione di funzione che viene utilizzata per descrivere ciò che la funzione fa in modo simile a JSDoc e Javadoc. Per visualizzare la formula in completamento automatico, il tag @customfunction deve essere specificato nel commento.

Esempio di base

Per evitare errori #DIV/0 sgradevoli in un foglio di calcolo, è possibile utilizzare una funzione personalizzata.

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

Per utilizzare la funzione, è necessario essere associato a un foglio di calcolo utilizzando l'editor di script ( Strumenti -> Editor di script ... ). Una volta aggiunta la funzione, può essere utilizzata come qualsiasi altra funzione di Google fogli chiamando la funzione nella formula di una cella.

Nota come la funzione si presenta in completamento automatico quando viene digitata in una formula. Ciò è dovuto al commento a più righe sopra la dichiarazione di funzione che viene utilizzata per descrivere ciò che la funzione fa in modo simile a JSDoc e Javadoc. Per visualizzare la formula in completamento automatico, il tag @customfunction deve essere specificato nel commento.