ฟังก์ชัน PY

นำไปใช้กับ
Excel for Microsoft 365 Excel for Microsoft 365 for Mac

หลังจากใส่ =PY ลงในเซลล์และเลือกฟังก์ชัน PY จากเมนูการทําให้สมบูรณ์อัตโนมัติ ประสบการณ์การแก้ไขเซลล์จะเปลี่ยนเป็นตัวแก้ไข Python เมื่อต้องการเรียนรู้เพิ่มเติม ให้ดู บทนําสู่ Python ใน Excel และ เริ่มต้นใช้งาน Python ใน Excel 

สำคัญ

ไม่สามารถใส่หรือเห็นฟังก์ชัน PY ได้โดยตรงจากแถบสูตรของ Excel แต่ตัวแก้ไข Python จะสร้างและแทรกลงในเซลล์ให้คุณแทน ไวยากรณ์ของฟังก์ชัน PY จะใช้โดย Add-in เพื่อแทรกหรืออ่านสูตร Python โดยตรงเป็นหลัก นอกจากนี้ยังสามารถเห็นได้เมื่อใช้ฟังก์ชัน FORMULATEXT บนเซลล์ที่มีสูตร Python 

ไวยากรณ์

ฟังก์ชัน PY เรียกใช้โค้ด Python บนรันไทม์ Microsoft Cloud ที่ปลอดภัย ผลลัพธ์จะถูกส่งกลับเป็นวัตถุ Python หรือค่า Excel 

=PY(python_code,return_type) 

อาร์กิวเมนต์ คำอธิบาย
python_code
(ต้องระบุ)
รหัส Python เพื่อทํางานบนรันไทม์ Microsoft Cloud ที่ปลอดภัย ต้องเป็นข้อความคงที่
return_type
(ต้องระบุ)
ระบุชนิดการส่งคืนที่ต้องการ ต้องเป็นตัวเลขคงที่ 0 หรือ 1
  • 0 ระบุค่า Excel
  • 1 ระบุวัตถุ Python

การอ้างอิง Excel

โค้ด Python สามารถอ้างอิงค่าใน Excel โดยใช้ฟังก์ชัน Python แบบกําหนดเอง xl().  

ฟังก์ชัน xl() สนับสนุนการอ้างอิงวัตถุ Excel ต่อไปนี้

  • ช่วง
  • ชื่อ
  • ตาราง
  • รูปภาพ
  • การเชื่อมต่อ Power Query

ฟังก์ชัน xl() จะสนับสนุนอาร์กิวเมนต์ส่วนหัวที่เป็นตัวเลือก อาร์กิวเมนต์ส่วนหัวจะระบุว่าแถวแรกมีส่วนหัวหรือไม่ ตัวอย่างเช่น xl("A1:Z10", headers=True) ระบุว่าเซลล์ A1:Z1 เป็นส่วนหัว 

ข้อสังเกต

  • ฟังก์ชัน PY สามารถดูได้โดย FORMULATEXT และเขียนและอ่านโดย Add-in
  • ฟังก์ชัน PY จะไม่สามารถมองเห็นได้ในแถบสูตร เนื่องจากจะแสดงโดยใช้ตัวแก้ไข Python 
  • ไม่สามารถใช้ฟังก์ชัน PY กับฟังก์ชันอื่นๆ ของ Excel ได้ ถ้าใช้กับฟังก์ชันอื่น จะไม่สามารถใส่สูตรได้
  • ทั้งอาร์กิวเมนต์ python_code และ return_type ต้องเป็นค่าคงที่

ตัวอย่าง

ตัวอย่างที่ 1 ใช้ตัวดําเนินการ Python plus เพื่อสร้าง "สวัสดี ทุกท่าน" จากส่วนข้อความ 3 ส่วน 

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

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

ตัวอย่างที่ xl() 2 ใช้ฟังก์ชันเพื่อรับข้อมูลจาก Table1 และส่งกลับผลลัพธ์เป็นวัตถุ Python 

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