Panduan memulai fungsi kustom

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

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

Tujuan

  • Siapkan 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 tempelkan kode di bawah ini. 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. Dalam sel, masukkan =salePrice(100,.2). Parameter pertama mewakili harga asli dan parameter kedua mewakili persentase diskon. Jika Anda berada di lokasi yang menggunakan koma desimal, Anda mungkin harus memasukkan =salePrice(100;0,2).

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

Langkah berikutnya

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