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

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

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

Цели

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

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

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

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

Настройте скрипт

  1. Создайте новую электронную таблицу .
  2. В созданной электронной таблице выберите пункт меню «Расширения» > «Apps Script» .

  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 .

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

Чтобы продолжить изучение возможностей расширения функциональности Google Sheets с помощью Apps Script, ознакомьтесь со следующими ресурсами: