Kurzanleitung zu benutzerdefinierten Funktionen

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

Im folgenden Schnellstartbeispiel wird eine benutzerdefinierte Funktion erstellt, mit der der Verkaufspreis von Artikeln mit Rabatt berechnet wird. Der Angebotspreis ist in US-Dollar angegeben.

Lernziele

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

Vorbereitung

Für dieses Beispiel müssen die folgenden Voraussetzungen erfüllt sein:

  • Ein Google-Konto (für Google Workspace-Konten ist möglicherweise die Genehmigung durch den Administrator erforderlich).
  • Ein Webbrowser mit Internetzugriff.

Skript einrichten

  1. Erstellen Sie eine neue Tabelle.
  2. Wählen Sie in der neuen Tabelle das Menü 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 Originalpreis und der zweite für den Rabattprozentsatz. Wenn Sie sich an einem Ort befinden, an dem Dezimalkommas verwendet werden, müssen Sie möglicherweise =salePrice(100;0,2) eingeben.

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

Nächste Schritte

Weitere Informationen dazu, wie Sie Google Tabellen mit Apps Script erweitern können, finden Sie in den folgenden Ressourcen: