Guía de inicio rápido: Función personalizada

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 la siguiente guía de inicio rápido de muestra, 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.

Antes de comenzar

Para usar esta muestra, necesitas los siguientes requisitos previos:

  • Una Cuenta de Google (Google Workspace cuentas pueden requerir la aprobación del administrador)
  • Un navegador web con acceso a Internet

Configurar

Nuevo editor

  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. Borre cualquier código que haya en el editor de secuencias de comandos y pegue el código que se encuentra a continuación.
/**
 * 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. En la parte superior, haz clic en Guardar .

Editor heredado

  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. Borre cualquier código que haya en el editor de secuencias de comandos y pegue el código que se encuentra a continuación.
/**
 * 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. Selecciona el elemento de menú Archivo &Guardar; Guardar. Asigna un nombre a la secuencia de comandos nueva y haz clic en Aceptar.

Pruébalo

  1. Vuelve 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, 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 función genera un precio de oferta de $80.00.

Para obtener más información sobre cómo extender Hojas de cálculo de Google con Apps Script, consulta los siguientes recursos: