Guide de démarrage rapide: Fonction personnalisée

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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

L'exemple de guide de démarrage rapide ci-dessous crée une fonction personnalisée qui calcule le prix soldé des articles à prix réduit. Le prix soldé est exprimé en dollars américains.

Avant de commencer

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

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

Configurer

  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.

    /**
     * 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. En haut, cliquez sur (enregistrer).

Essayer

  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 paramètre le pourcentage de remise. Si vous vous trouvez dans une zone comportant des virgules décimales, vous devrez peut-être saisir =salePrice(100;0,2) à la place.

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

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