Guida rapida alle funzioni personalizzate

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

Il seguente esempio di guida rapida crea una funzione personalizzata che calcola il prezzo di vendita degli articoli scontati. Il prezzo scontato è formattato in dollari statunitensi.

Obiettivi

  • Configura lo script.
  • Esegui lo script.

Prerequisiti

Per utilizzare questo esempio, devi soddisfare 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 la voce 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 parametro rappresenta la percentuale di sconto. Se ti trovi in una località che utilizza le virgole decimali, potresti dover inserire =salePrice(100;0,2).

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

Passaggi successivi

Per continuare a scoprire come estendere Fogli con Apps Script, consulta le seguenti risorse: