Guide de démarrage rapide sur les fonctions personnalisées

Vous pouvez utiliser Google Apps Script pour créer une fonction personnalisée, puis l'utiliser dans Google Sheets comme une fonction intégrée.

L'exemple de démarrage rapide suivant crée une fonction personnalisée qui calcule le prix soldé des articles en promotion. Le prix soldé est exprimé en dollars américains.

Objectifs

  • Configurez le script.
  • Exécutez le script.

Conditions préalables

Pour utiliser cet exemple, vous devez remplir les conditions préalables suivantes:

  • Un compte Google (les comptes Google Workspace peuvent nécessiter une approbation de l'administrateur).
  • Un navigateur Web ayant accès à Internet.

Configurer le script

  1. Créez une feuille de calcul.
  2. Dans votre nouvelle feuille de calcul, sélectionnez l'élément de menu Extensions > Apps Script.
  3. Supprimez tout code éventuellement présent dans l'éditeur de scripts, puis collez dans ce dernier le code ci-dessous. Cliquez ensuite sur Enregistrer Icône d'enregistrement.

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

Exécuter le script

  1. Revenez à la feuille de calcul.
  2. Dans une cellule, saisissez =salePrice(100,.2). Le premier paramètre représente le prix d'origine et le second correspond au pourcentage de remise. Si vous vous trouvez dans un lieu utilisant des virgules décimales, vous devrez peut-être saisir =salePrice(100;0,2).

La fonction génère un prix soldé de $80.00.

Étapes suivantes

Pour découvrir comment étendre Sheets avec Apps Script, consultez les ressources suivantes: