Panduan memulai fungsi kustom

Anda dapat menggunakan Google Apps Script untuk menulis fungsi khusus, lalu menggunakannya di {i>Google Sheets<i} seperti fungsi {i>built-in<i}.

Contoh panduan memulai berikut membuat fungsi khusus 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 akun baru {i>spreadsheet<i} Anda.
  2. Dari dalam {i>spreadsheet<i} baru Anda, pilih item menu Ekstensi &gt; Apps Script.

  3. Hapus kode apa pun di editor skrip dan tempelkan kode di bawah ini. Selanjutnya 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 menunjukkan persentase diskon. Jika Anda berada di lokasi yang menggunakan koma desimal, Anda mungkin harus memasukkan Sebagai gantinya, =salePrice(100;0,2).

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

Langkah berikutnya

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