Guía de inicio rápido de las funciones personalizadas

Puedes usar Google Apps Script para escribir una función personalizada y, luego, usarla en Hojas de cálculo de Google como una función integrada.

En el siguiente ejemplo de la guía de inicio rápido, se crea una función personalizada que calcula el precio de oferta de los artículos con descuento. El precio de oferta tiene el formato de dólares estadounidenses.

Objetivos

• Configura la secuencia de comandos.
• Ejecuta la secuencia de comandos.

Requisitos previos

Para usar esta muestra, debes cumplir con los siguientes requisitos previos:

• Una Cuenta de Google (es posible que las cuentas de Google Workspace requieran aprobación del administrador)
• Un navegador web con acceso a Internet

Configura la secuencia de comandos

1. Crea una hoja de cálculo nueva.
2. En la hoja de cálculo nueva, selecciona el elemento de menú Extensiones > Apps Script.

3. Borra cualquier código que haya en el editor de secuencias de comandos y pega el código que se encuentra a continuación. Luego, haz clic en Guardar .

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

Ejecuta la secuencia de comandos:

1. Regresa a tu hoja de cálculo.
2. En una celda, ingresa =salePrice(100,.2). El primer parámetro representa el precio original y el segundo parámetro representa el porcentaje de descuento. Si te encuentras en una ubicación que usa comas decimales, es posible que debas ingresar =salePrice(100;0,2).

La fórmula que ingresas en la celda ejecuta la función en la secuencia de comandos que creaste en la sección anterior. La función genera un precio de oferta de $80.00.

Próximos pasos

Para seguir aprendiendo a extender Hojas de cálculo con Apps Script, consulta los siguientes recursos:

• Funciones personalizadas de Hojas de cálculo
• Menús personalizados en Google Workspace
• Cómo ampliar Hojas de cálculo de Google