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

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Use o Google Apps Script para criar uma função personalizada e use ela no Planilhas Google como uma função integrada.

A amostra de início rápido abaixo cria uma função personalizada que calcula o preço de venda de itens com desconto. O preço promocional é formatado como dólares americanos.

Antes de começar

Para usar esta amostra, você precisa dos seguintes pré-requisitos:

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

Configurar

  1. Crie uma nova 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.

    /**
     * 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);
    }
    
  4. Na parte superior, clique em Salvar .

Fazer um teste

  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 de desconto. Se você estiver em um local que usa vírgulas decimais, talvez seja necessário inserir =salePrice(100;0,2).

A função resulta em um preço promocional de $80.00.

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