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

ข้อสังเกต

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

ตัวอย่าง

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

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

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

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

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