Guida rapida alle funzioni personalizzate

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

L'esempio di guida rapida riportato di seguito 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, devi disporre dei seguenti prerequisiti:

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

Configura 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. 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 virgole decimali, potrebbe essere necessario inserire =salePrice(100;0,2).

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

Passaggi successivi

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