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

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 démarrage rapide suivant crée une fonction personnalisée qui calcule le prix de vente des articles soldés. Le prix de vente est indiqué en dollars américains.

Objectifs

  • Configurer le script
  • Exécuter le script

Prérequis

Pour utiliser cet exemple, vous devez répondre aux exigences suivantes :

  • Un compte Google (l'approbation de l'administrateur peut être nécessaire pour les comptes Google Workspace)
  • Un navigateur Web avec accès à Internet

Configurer le script

  1. Créez une nouvelle 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 le code suivant. Cliquez ensuite sur Enregistrer Icône de disquette utilisée pour enregistrer le projet.

    /**
 * 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 à votre feuille de calcul.
  2. Dans une cellule, saisissez =salePrice(100,20). Le premier paramètre représente le prix d'origine et le second le pourcentage de remise. Si vous vous trouvez dans un pays où les virgules décimales sont utilisées, vous devrez peut-être saisir =salePrice(100;20).

La formule que vous saisissez dans la cellule exécute la fonction dans le script que vous avez créé dans la section précédente. La fonction génère un prix de vente de $80.00.

Étapes suivantes

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