Guida rapida alle funzioni personalizzate

Puoi utilizzare Google Apps Script per scrivere una funzione personalizzata, quindi utilizzarla in Fogli Google come una funzione integrata.

Il seguente esempio di Quickstart crea una funzione personalizzata che calcola il prezzo scontato degli articoli in promozione. Il prezzo scontato è formattato in dollari statunitensi.

Obiettivi

  • Configura lo script.
  • Esegui lo script.

Prerequisiti

Per utilizzare questo esempio, sono necessari i seguenti prerequisiti:

  • Un Account Google (gli account Google Workspace potrebbero richiedere l'approvazione dell'amministratore).
  • Un browser web con accesso a internet.

Configurare lo script

  1. Crea un nuovo foglio di lavoro.
  2. Nel nuovo foglio di lavoro, seleziona l'elemento di menu Estensioni > Apps Script.

  3. Elimina qualsiasi codice nell'editor di script e incolla il codice riportato di seguito. Poi, fai clic su Salva Icona Salva.

    /**
 * Calculates the sale price of a value at a given discount.
 * The sale price is formatted as US dollars.
 *
 * @param {number} input The value to discount.
 * @param {number} discount The discount to apply, such as .5 or 50%.
 * @return The sale price formatted as USD.
 * @customfunction
 */
function salePrice(input, discount) {
  let price = input - (input * discount);
  let dollarUS = Intl.NumberFormat("en-US", {
    style: "currency",
    currency: "USD",
});
  return dollarUS.format(price);
}

Esegui lo script

  1. Torna al foglio di lavoro.
  2. In una cella, inserisci =salePrice(100,.2). Il primo parametro rappresenta il prezzo originale e il secondo la percentuale di sconto. Se ti trovi in una località in cui vengono utilizzate le virgole decimali, potresti dover inserire =salePrice(100;0,2).

La formula inserita nella cella esegue la funzione nello script che hai creato nella sezione precedente. La funzione restituisce un prezzo di vendita di $80.00.

Passaggi successivi

Per scoprire di più su come estendere Fogli con Apps Script, consulta le seguenti risorse: