Guia de início rápido da função personalizada

Você pode usar o Google Apps Script para criar uma função personalizada e usá-la em o Planilhas Google como uma função integrada.

O exemplo de início rápido a seguir cria uma função personalizada que calcula o preço promocional de itens com desconto. O preço promocional está formatado como dólares americanos.

Objetivos

  • Configure o script.
  • Execute o script.

Pré-requisitos

Para usar este exemplo, você precisa dos seguintes pré-requisitos:

  • Uma Conta do Google (as contas do Google Workspace podem precisam da aprovação do administrador).
  • Um navegador da Web com acesso à Internet.

Configurar o script

  1. Crie um novo planilha.
  2. Na nova planilha, selecione o item de menu Extensões > Apps Script.

  3. Apague o código no editor de script (se houver algum) e cole o código abaixo. Depois, clique em Salvar Ícone "Salvar".

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

Executar o script

  1. Volte para sua planilha.
  2. Em uma célula, digite =salePrice(100,.2). O primeiro parâmetro representa o preço original, e o segundo representa a porcentagem do desconto. Se você estiver em um local que use vírgulas decimais, talvez seja necessário inserir =salePrice(100;0,2).

A fórmula que você insere na célula executa a função na o script que você criou na seção anterior. A função resulta em uma venda preço de $80.00.

Próximas etapas

Para continuar aprendendo sobre como estender o Planilhas com Apps Script, confira consulte os seguintes recursos: