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.

Ziele

  • Das Script einrichten.
  • 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.

Script einrichten

  1. Erstellen Sie eine neue Tabelle.
  2. Klicken Sie in der neuen Tabelle auf den Menüpunkt Erweiterungen > Apps Script.

  3. Löschen Sie vorhandenen Code im Script-Editor und fügen Sie folgenden 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 Script 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: