הפונקציה PY

חל על
Excel של Microsoft 365 Excel של Microsoft 365 עבור Mac

לאחר הזנת =PY לתא ובחירת הפונקציה PY מתפריט ההשלמה האוטומטית, חוויית עריכת התאים הופכת לעורך Python. לקבלת מידע נוסף, ראה מבוא ל- Python ב- Excelותחילת העבודה עם Python ב- Excel. 

חשוב

לא ניתן להזין או לראות את פונקציית PY ישירות משורת הנוסחאות של Excel, במקום זאת עורך Python יפיק אותה ויכניס אותה לתא עבורך. תחביר הפונקציה PY משמש בעיקר תוספות להוספה או לקריאה ישירה של נוסחאות 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 ניתנת לצפייה ב - FORMULATEXT ולכתיבה ולקריאה על-ידי תוספות.
  • הפונקציה PY אינה גלויה בשורת הנוסחאות מכיוון שהיא מוצגת באמצעות עורך Python. 
  • לא ניתן להשתמש בפונקציה PY עם פונקציות אחרות של Excel. אם נעשה שימוש בנוסחה עם פונקציות אחרות, לא ניתן להזין נוסחה.
  • הארגומנטים python_code ו return_type חייבים להיות סטטיים.

דוגמאות

דוגמה 1 משתמשת באופרטור Python plus כדי ליצור "Hello World" מ- 3 קטעי טקסט. 

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

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

דוגמה 2 משתמשת בפונקציה xl() כדי להשיג את הנתונים מטבלה1 ומחזירה את התוצאה כאובייקט Python. 

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