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 es como una función integrada.

La siguiente guía de inicio rápido de muestra crea una función personalizada que calcula el el precio de oferta de los artículos con descuento. El precio de oferta debe tener el formato de dólares estadounidenses.

Objetivos

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

Requisitos previos

Para usar esta muestra, necesitas los siguientes requisitos previos:

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

Configura la secuencia de comandos

1. Crear un nuevo en una hoja de cálculo.
2. Desde tu nueva hoja de cálculo, 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. Después 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. Vuelve a tu hoja de cálculo.
2. En una celda, ingresa =salePrice(100,.2). El primer parámetro representa la precio original, y el segundo parámetro representa el porcentaje de descuento. Si te encuentras en una ubicación que usa comas decimales, quizás debas ingresar =salePrice(100;0,2) en su lugar.

La fórmula que ingreses en la celda ejecutará la función en la de comandos que creaste en la sección anterior. La función da como resultado una venta con un precio de $80.00.

Próximos pasos

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

• Funciones personalizadas de la hoja de cálculo
• Menús personalizados en Google Workspace
• Extender Hojas de cálculo de Google