Fungsi PY

Berlaku Untuk
Excel untuk Microsoft 365 Excel untuk Microsoft 365 untuk Mac

Setelah memasukkan =PY ke dalam sel dan memilih fungsi PY dari menu LengkapiOtomatis, pengalaman pengeditan sel berubah menjadi editor Python. Untuk mempelajari selengkapnya, lihat Pengenalan Python di Excel dan Mulai menggunakan Python di Excel. 

Penting

Fungsi PY tidak bisa langsung dimasukkan atau dilihat dari bilah rumus Excel, sebagai gantinya editor Python akan menghasilkannya dan menyisipkannya ke dalam sel untuk Anda. Sintaks fungsi PY terutama digunakan oleh add-in untuk menyisipkan atau membaca rumus Python secara langsung. Fungsi ini juga dapat dilihat ketika menggunakan fungsi FORMULATEXT pada sel yang berisi rumus Python. 

Sintaks

Fungsi PY menjalankan kode Python pada runtime Microsoft Cloud yang aman. Hasilnya dikembalikan sebagai objek Python atau nilai Excel. 

=PY(python_code,return_type) 

Argumen Deskripsi
python_code
(diperlukan)		 Kode Python untuk dijalankan pada runtime Microsoft Cloud yang aman. Harus berupa teks statis.
return_type
(diperlukan)		 Tentukan tipe pengembalian yang diinginkan. Harus berupa angka statis 0 atau 1.
  • 0 menunjukkan nilai Excel.
  • 1 menunjukkan objek Python.

Referensi Excel

Kode Python bisa mereferensikan nilai di Excel dengan menggunakan fungsi Python kustom xl().  

Fungsi ini xl() mendukung referensi objek Excel berikut ini.

  • Rentang
  • Nama
  • Tabel
  • Gambar
  • Koneksi Power Query

Fungsi ini xl() mendukung argumen header opsional. Argumen header menentukan apakah baris pertama memiliki header. Misalnya, xl("A1:Z10", headers=True) menunjukkan bahwa sel A1:Z1 adalah header. 

Keterangan

  • Fungsi PY dapat dilihat oleh FORMULATEXT dan ditulis dan dibaca oleh add-in.
  • Fungsi PY tidak terlihat di bilah rumus karena ditampilkan menggunakan editor Python. 
  • Fungsi PY tidak bisa digunakan dengan fungsi Excel lainnya. Jika digunakan dengan fungsi lain, rumus tidak dapat dimasukkan.
  • Argumen python_code dan return_type harus statis.

Contoh

Contoh 1 menggunakan operator Python plus untuk menghasilkan "Halo Dunia" dari 3 fragmen teks. 

=PY('Hello' + ' ' + 'World',0) 

 ———————————————————————————

Contoh 2 menggunakan fungsi untuk xl() mendapatkan data dari Table1 dan mengembalikan hasil sebagai objek Python. 

=PY("xl(""Table1[#All]"", headers=True)",1)