Panduan memulai fungsi kustom

Anda dapat menggunakan Google Apps Script untuk menulis fungsi kustom, lalu menggunakannya di Google Spreadsheet seperti fungsi bawaan.

Contoh panduan memulai berikut membuat fungsi kustom yang menghitung harga promo item yang didiskon. Harga promo diformat sebagai dolar AS.

Tujuan

  • Menyiapkan skrip.
  • Jalankan skrip.

Prasyarat

Untuk menggunakan contoh ini, Anda memerlukan prasyarat berikut:

  • Akun Google (akun Google Workspace mungkin memerlukan persetujuan administrator).
  • Browser web dengan akses ke internet.

Menyiapkan skrip

  1. Buat spreadsheet baru.
  2. Dari dalam spreadsheet baru, pilih item menu Ekstensi > Apps Script.
  3. Hapus kode apa pun di editor skrip dan tempel kode di bawah. Lalu, klik Simpan Ikon simpan.

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

Jalankan skrip:

  1. Beralih kembali ke spreadsheet Anda.
  2. Di sel, masukkan =salePrice(100,.2). Parameter pertama merepresentasikan harga asli dan parameter kedua merepresentasikan persentase diskon. Jika Anda berada di lokasi yang menggunakan koma desimal, Anda mungkin perlu memasukkan =salePrice(100;0,2) sebagai gantinya.

Formula yang Anda masukkan di sel akan menjalankan fungsi dalam skrip yang Anda buat di bagian sebelumnya. Fungsi ini menghasilkan harga promo $80.00.

Langkah berikutnya

Untuk terus mempelajari cara memperluas Spreadsheet dengan Apps Script, lihat referensi berikut: