Guida rapida alle funzioni personalizzate

Puoi utilizzare Google Apps Script per scrivere una funzione personalizzata, che puoi utilizzare in Fogli Google come se fosse una funzione incorporata.

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

Obiettivi

  • Configura lo script.
  • Esegui lo script.

Prerequisiti

Per utilizzare questo campione, 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. All'interno del nuovo foglio di lavoro, seleziona la voce di menu Estensioni > Apps Script.
  3. Elimina il codice nell'editor di script e incollalo nel seguente codice. 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. Inserisci =salePrice(100,.2) in una cella. Il primo parametro rappresenta il prezzo originale, mentre il secondo 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 inserita nella cella esegue la funzione nello script creato nella sezione precedente. La funzione restituisce un prezzo scontato di $80.00.

Passaggi successivi

Per continuare a sapere come estendere Fogli con Apps Script, dai un'occhiata alle seguenti risorse: