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 della guida rapida crea una funzione personalizzata che calcola il prezzo scontato degli articoli scontati. 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 potrebbe 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 il codice nell'editor di script e incolla il codice seguente. 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à che utilizza le virgole decimali, potresti dover inserire invece =salePrice(100;0,2).

La formula inserita nella cella esegue la funzione nello script creato nella sezione precedente. La funzione genera un prezzo scontato di $80.00.

Passaggi successivi

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