Krótkie wprowadzenie do funkcji niestandardowej

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

Poniższy przykład szybkiego startu tworzy funkcję niestandardową, która oblicza cenę promocyjną produktów z rabatem. Cena promocyjna jest sformatowana jako dolary amerykańskie.

Cele

  • Skonfiguruj skrypt.
  • Uruchom skrypt.

Wymagania wstępne

Aby użyć tego przykładu, musisz spełnić te wymagania wstępne:

  • Konto Google (w przypadku kont Google Workspace może być wymagana zgoda administratora).
  • przeglądarkę internetową z dostępem do internetu,

Konfigurowanie skryptu

  1. Utwórz nowy arkusz kalkulacyjny.
  2. W nowym arkuszu kalkulacyjnym wybierz kolejno Rozszerzenia > Apps Script.

  3. Usuń cały kod z edytora skryptów i wklej poniższy kod. 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);
}

Uruchamianie skryptu

  1. Wróć do arkusza kalkulacyjnego.
  2. W komórce wpisz =salePrice(100,.2). Pierwszy parametr to cena pierwotna, a drugi to rabat procentowy. Jeśli jesteś w lokalizacji, w której używa się przecinków dziesiętnych, może być konieczne wpisanie =salePrice(100;0,2).

Formuła wpisana w komórce uruchamia funkcję w skrypcie utworzonym w poprzedniej sekcji. Funkcja zwraca cenę promocyjną $80.00.

Dalsze kroki

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