Applies ToExcel untuk Microsoft 365 Excel 2019 Excel 2016 Excel 2013 Excel 2010

Fungsi kustom menggunakan bahasa rumus M, mengambil serangkaian nilai input, lalu mengembalikan sebuah nilai output. Jika memiliki logika yang ingin digunakan kembali beberapa kali atau menerapkan kumpulan transformasi yang sama ke kueri atau nilai yang berbeda, pertimbangkan untuk membuat fungsi kustom, lalu buka fungsi di mana dan kapan Anda membutuhkannya. Ada beberapa cara untuk membuat fungsi kustom: 

  • Gunakan Editor Tingkat Lanjut untuk menambahkan pernyataan mari Anda sendiri dan mulai dari awal.

  • Menggunakan perintah Invoke Custom Function.

  • Ada cara lain untuk membuat fungsi yang tidak dibahas dalam topik bantuan ini termasuk Membuat Fungsi dan Menambahkan sebagai perintah Kueri. Untuk diskusi mendalam, lihat Memahami fungsi M Power Query (dalam docs.com)dan Menggunakan fungsi kustom (docs.com).

Berikut contoh sederhana fungsi kustom yang mengikuti pemrograman yang sudah berlangsung lama.

  1. Untuk membuat kueri kosong: Excel Pilih Data> Dapatkan       Data > Dari Sumber Lain > Kueri Kosong.Power Query      Klik kanan di tempat kosong di panel Kueri di sebelah kiri, lalu pilih Sumber > Sumber Lain > Kueri Kosong.

  2. Di panel Kueri di sebelah kiri, klik dua kali pada nama, lalu ganti nama kueri kosong baru menjadi "HelloWorld".

  3. Pilih kueri baru lalu pilih Beranda > Editor Tingkat Lanjut.

  4. Ganti kode awal templat dengan kode berikut:

    let      HelloWorld = () => ("Hello World") in      HelloWorld

  5. Pilih Selesai.

  6. Anda telah mengubah kueri, "HelloWorld", menjadi fungsi kustom. Perhatikan bahwa ikon fungsi Ikon Fungsi di sebelah kirinya.

  7. Untuk menjalankan fungsi, pilih, lalu pilih Invoke di Pratinjau Data.Buka fungsi kustom HelloWorld

  8. Hasil fungsi ditampilkan di Pratinjau data dan ditambahkan ke panel Kueri sebagai kueri dengan nama default, Fungsi Invoked. Anda mungkin ingin mengganti namanya dengan sesuatu yang lebih bermakna, seperti "HelloWorldResult".

  9. Pilih kueri tersebut, lalu pilih Beranda > Tutup & Muat untuk melihat hasilnya dalam lembar kerja.

Hasil 

Hasil HelloWorld dalam lembar kerja

Contoh berikut ini memperlihatkan cara meneruskan parameter ke fungsi kustom untuk mengonversi angka desimal menjadi heksadesimal.

  1. Untuk membuat kueri kosong: Excel Pilih Data> Dapatkan       Data > Dari Sumber Lain > Kueri Kosong.Power Query      Klik kanan di tempat kosong di panel Kueri di sebelah kiri, lalu pilih Sumber > Sumber Lain > Kueri Kosong.

  2. Di panel Kueri di sebelah kiri, ganti nama kueri kosong baru menjadi "MyHex".

  3. Pilih kueri baru lalu pilih Beranda > Editor Tingkat Lanjut.

  4. Ganti kode awal templat dengan kode berikut:

    let      MyHex = (parameter1) => Number.ToText(parameter1,"X") in      MyHex

  5. Pilih Selesai.

  6. Anda telah mengubah kueri, "MyHex", menjadi fungsi kustom. Perhatikan bahwa ikon fungsi Ikon Fungsi di sebelah kirinya.

  7. Untuk menjalankan fungsi, pilih fungsi, lalu di Pratinjau Data, masukkan angka dalam kotak parameter1, dan pilih Invoke.

    Menggunakan fungsi kustom MyHex

  8. Hasil fungsi ditampilkan dalam Pratinjau data dan ditambahkan ke panel Kueri sebagai kueri dengan nama default, Fungsi Invoked. Anda mungkin ingin mengganti namanya menjadi sesuatu yang lebih bermakna, seperti "MyHexResult".

  9. Pilih kueri tersebut, lalu pilih Beranda > Tutup & Muat untuk melihat hasilnya dalam lembar kerja.

Hasil 

Hasil fungsi MyHex di lembar kerja

Jika Anda telah membuat fungsi dengan setidaknya satu parameter, Anda bisa menjalankannya sebagai fungsi kustom untuk membuat kolom baru dan nilai baru untuk setiap baris dalam tabel.

  1. Untuk membuka kueri, temukan yang sebelumnya dimuat dari Editor Power Query, pilih sel dalam data, lalu pilih Kueri >Edit. Untuk informasi selengkapnya, lihat Membuat, mengedit, dan memuat kueri di Excel (Power Query).Catatan    Untuk contoh ini, kueri Anda membutuhkan setidaknya satu kolom tipe data Angka Seluruh.

  2. Buat fungsi kustom "MyHex" seperti yang dijelaskan di bagian, Membuat dan menjalankan fungsi kustom yang memiliki parameter dengan Editor Tingkat Lanjut.

  3. In the query, select Add Column > Invoke Custom Function. Kotak dialog Invoke Custom Function muncul.

  4. Masukkan nama kolom baru, seperti "HexConvert", dalam kotak Nama kolom baru.

  5. Pilih nama fungsi kustom yang telah ditetapkan sebelumnya dari menu menurun Kueri fungsi. Dalam contoh ini, pilih "MyHex".

  6. Karena fungsi kustom merujuk sebuah parameter, parameter sekarang ditampilkan.

  7. Pilih kolom tipe data Angka Seluruh sebagai parameter fungsi.Kotak dialog Invoke Custom Function

  8. Pilih OK.

Hasil

Kolom baru dibuat yang memperlihatkan nilai Heksadesimal kolom Angka Seluruh yang Anda masukkan sebagai parameter.

Kolom nilai MyHex yang baru dalam lembar kerja

Lihat Juga

Power Query untuk Excel Bantuan

Membuat rumus Power Query di Excel

Membuat kueri parameter

Mengelola kueri

Memahami fungsi M Power Query (docs.com)

Menggunakan fungsi kustom (docs.com)

Perlu bantuan lainnya?

Ingin opsi lainnya?

Jelajahi manfaat langganan, telusuri kursus pelatihan, pelajari cara mengamankan perangkat Anda, dan banyak lagi.

Komunitas membantu Anda bertanya dan menjawab pertanyaan, memberikan umpan balik, dan mendengar dari para ahli yang memiliki pengetahuan yang luas.