google-apps-script
Maak een aangepaste functie voor Google Spreadsheets
Zoeken…
Invoering
Een aangepaste functie in Google Documenten is gekoppeld aan een specifiek document (en kan dus alleen in dat document worden gebruikt).
Het moet daarom worden gemaakt met de scriptbewerking van dat document (Extra -> Scripteditor). Eenmaal opgeslagen, kan het worden gebruikt als elke andere reguliere spreadsheetformule.
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.