Kurzanleitung zu benutzerdefinierten Funktionen

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

Im folgenden Kurzanleitungsbeispiel wird eine benutzerdefinierte Funktion erstellt, die den Sonderangebotspreis von rabattierten Artikeln berechnet. Der Sonderangebotspreis ist als US-Dollar formatiert.

Zielsetzungen

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

Voraussetzungen

Damit Sie dieses Beispiel verwenden können, müssen folgende Voraussetzungen erfüllt sein:

  • Ein Google-Konto (Google Workspace-Konten erfordern möglicherweise die Genehmigung eines Administrators).
  • Ein Webbrowser mit Zugriff auf das 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 Originalpreis und der zweite Parameter für den Rabattprozentsatz. Wenn Sie sich an einem Standort befinden, in dem Dezimalkomma verwendet wird, müssen Sie möglicherweise stattdessen =salePrice(100;0,2) eingeben.

Die Formel, die Sie in die Zelle eingeben, führt die Funktion in dem Skript aus, das Sie im vorherigen Abschnitt erstellt haben. Die Funktion ergibt einen Sonderangebotspreis von $80.00.

Nächste Schritte

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