Fungsi PY
Applies To
Excel untuk Microsoft 365Setelah 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 addin untuk menyisipkan atau membaca rumus Python dengan jarang. 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. Sintaks di bawah ini
=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.
|
Referensi Excel
Kode Python bisa mereferensikan nilai di Excel dengan menggunakan fungsi Python kustom xl().
Fungsixl()mendukung referensi objek Excel berikut.
-
Rentang
-
Nama
-
Tabel
-
koneksi Power Query
Fungsi 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. diatur secara otomatis.
-
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 xl() untuk mendapatkan data dari Table1 dan mengembalikan hasilnya sebagai objek Python.
=PY("xl(""Table1[#All]"", headers=True)",1)