Kurzanleitung zu benutzerdefinierten Funktionen

Mit Google Apps Script können Sie eine benutzerdefinierte Funktion schreiben und diese dann in Google Tabellen wie eine integrierte Funktion verwenden.

Im folgenden Schnellstartbeispiel wird eine benutzerdefinierte Funktion erstellt, die den Verkaufspreis von rabattierten Artikeln berechnet. Der Sonderangebotspreis ist in US-Dollar angegeben.

Zielsetzungen

  • Richten Sie das Skript ein.
  • Führen Sie das Skript aus.

Voraussetzungen

Um dieses Beispiel zu verwenden, müssen die folgenden Voraussetzungen erfüllt sein:

  • Ein Google-Konto (für Google Workspace-Konten ist möglicherweise die Administratorgenehmigung erforderlich).
  • Ein Webbrowser mit Zugang zum Internet.

Skript einrichten

  1. Erstellen Sie eine neue Tabelle.
  2. Wählen Sie in der neuen Tabelle den Menüpunkt Erweiterungen > Apps Script aus.
  3. Löschen Sie jeglichen Code im Skripteditor und fügen Sie den unten angegebenen Code ein. Klicken Sie dann auf „Speichern“ Symbol „Speichern“.

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

Skript ausführen

  1. Wechseln Sie zurück zur Tabelle.
  2. Geben Sie in eine Zelle =salePrice(100,.2) ein. Der erste Parameter steht für den ursprünglichen Preis und der zweite Parameter für den Rabattprozentsatz. Wenn Sie sich an einem Ort befinden, an dem Dezimaltrennzeichen verwendet werden, müssen Sie stattdessen möglicherweise =salePrice(100;0,2) eingeben.

Mit der Formel, die Sie in die Zelle eingeben, wird die Funktion in dem Skript ausgeführt, das Sie im vorherigen Abschnitt erstellt haben. Die Funktion führt zu einem Sonderangebotspreis von $80.00.

Nächste Schritte

Weitere Informationen zum Erweitern von Tabellen mit Apps Script finden Sie in den folgenden Ressourcen: