Kurzanleitung zu benutzerdefinierten Funktionen

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

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

Ziele

  • Das Script einrichten.
  • Das Script ausführen.

Vorbereitung

Für dieses Beispiel sind folgende Voraussetzungen erforderlich:

  • Ein Google-Konto (für Google Workspace-Konten ist möglicherweise die Genehmigung durch einen 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 einer Diskette zum Speichern des Projekts.

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

Script ausführen

  1. Wechseln Sie zurück zur Tabelle.
  2. Geben Sie in eine Zelle =salePrice(100,20) ein. Der erste Parameter steht für den ursprünglichen Preis und der zweite Parameter für den Rabatt in Prozent. Wenn Sie sich an einem Ort befinden, an dem Kommas als Dezimaltrennzeichen verwendet werden, müssen Sie möglicherweise stattdessen =salePrice(100;20) 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 ergibt einen Verkaufspreis von $80.00.

Nächste Schritte

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