Краткое руководство по пользовательским функциям

Вы можете использовать Google Apps Script для написания пользовательской функции, а затем использовать ее в Google Sheets как встроенную функцию.

В следующем кратком примере создается пользовательская функция, которая вычисляет цену продажи товаров со скидкой. Цена продажи указывается в долларах США.

Цели

  • Настройте сценарий.
  • Запустите скрипт.

Предварительные условия

Для использования этого образца необходимы следующие предварительные условия:

  • Учетная запись Google (для учетных записей Google Workspace может потребоваться одобрение администратора).
  • Веб-браузер с доступом в Интернет.

Настройте сценарий

  1. Создайте новую электронную таблицу .
  2. В новой электронной таблице выберите пункт меню «Расширения» > «Скрипт приложений» .
  3. Удалите весь код в редакторе скриптов и вставьте код ниже. Затем нажмите Сохранить Значок сохранения .

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

Запустите сценарий

  1. Вернитесь к электронной таблице.
  2. В ячейке введите =salePrice(100,.2) . Первый параметр представляет исходную цену, а второй параметр представляет процент скидки. Если вы находитесь в регионе, где используются десятичные запятые, вам может потребоваться вместо этого ввести =salePrice(100;0,2) .

Формула, которую вы вводите в ячейку, запускает функцию в скрипте, который вы создали в предыдущем разделе. Функция дает цену продажи $80.00 .

Следующие шаги

Чтобы продолжить изучение того, как расширить Таблицы с помощью Apps Script, ознакомьтесь со следующими ресурсами: