Krótkie wprowadzenie do funkcji niestandardowej

Za pomocą Google Apps Script możesz napisać niestandardową funkcję, a potem używać jej w Arkuszach Google tak samo jak funkcji wbudowanej.

Poniższy przykład krótkiego wprowadzenia umożliwia utworzenie funkcji niestandardowej, która oblicza cenę promocyjną produktów z rabatem. Cena promocyjna jest podana w dolarach amerykańskich.

Cele

  • Skonfiguruj skrypt.
  • Uruchom skrypt.

Wymagania wstępne

Aby korzystać z tego przykładu, musisz spełnić te wymagania wstępne:

  • konta Google (konta Google Workspace mogą wymagać zatwierdzenia przez administratora),
  • Przeglądarka z dostępem do internetu.

Konfigurowanie skryptu

  1. Utwórz nowy arkusz kalkulacyjny.
  2. W nowym arkuszu kalkulacyjnym wybierz pozycję menu Rozszerzenia > Apps Script.
  3. Usuń cały kod z edytora skryptów i wklej go poniżej. Następnie kliknij Zapisz Ikona zapisania.

    /**
     * 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);
    }
    

Uruchom skrypt

  1. Wróć do arkusza kalkulacyjnego.
  2. W komórce wpisz =salePrice(100,.2). Pierwszy parametr określa cenę pierwotną, a drugi – wartość procentową rabatu. Jeśli w Twojej lokalizacji występuje przecinki dziesiętne, konieczne może być wpisanie wartości =salePrice(100;0,2).

Formuła wpisana w komórce uruchamia funkcję w skrypcie utworzonym w poprzedniej sekcji. Wynikiem jest cena promocyjna $80.00.

Dalsze kroki

Jeśli chcesz dowiedzieć się więcej o rozszerzaniu Arkuszy za pomocą Apps Script, zapoznaj się z tymi materiałami: