Panduan memulai fungsi kustom

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

Contoh 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 semua kode di editor skrip dan tempel kode di bawah. Kemudian, 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 mewakili harga asli dan parameter kedua mewakili persentase diskon. Jika berada di lokasi yang menggunakan koma desimal, Anda mungkin perlu memasukkan =salePrice(100;0,2).

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

Langkah berikutnya

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