הפונקציה PY
Applies To
Excel של Microsoft 365לאחר הזנת =PY בתא ובחירה בפונקציה PY מתפריט 'השלמה אוטומטית', חוויית עריכת התא הופכת לעורך Python. לקבלת מידע נוסף, ראה מבוא ל- Python ב- Excelוהתחלת העבודה עם Python ב- Excel.
חשוב: לא ניתן להזין או לראות ישירות את הפונקציה PY משורת הנוסחאות של Excel, במקום זאת, עורך Python ייצור אותה ומוסיף אותה לתא עבורך. תחביר הפונקציה PY משמש בעיקר על-ידי תוספות להוספה או לקריאה של נוסחאות Python. ניתן לראות אותה גם בעת שימוש FORMULATEXT בתא המכיל נוסחת Python.
תחביר
הפונקציה PY מפעילה קוד Python בזמן ריצה מאובטח בענן של Microsoft. התוצאה מוחזרת אובייקט Python או כערך של Excel. התחביר שלהלן
=PY(python_code,return_type)
ארגומנט |
תיאור |
python_code (נדרש) |
קוד Python לפעול בזמן ריצה מאובטח בענן של Microsoft. חייב להיות טקסט סטטי. |
return_type (נדרש) |
ציין את סוג ההחזרה הרצוי. חייב להיות מספר סטטי 0 או 1.
|
הפניות ל- Excel
קוד Python יכול להפנות לערכים ב- Excel באמצעות הפונקציה המותאמת אישית Python xl().
הפונקציהxl()תומכת בהפניה לאובייקטים הבאים של Excel.
-
טווחים
-
שמות
-
טבלאות
-
Power Query חיבורים
הפונקציה xl() תומכת בארגומנט כותרות אופציונלי. הארגומנט headers מציין אם השורה הראשונה כוללת כותרות. לדוגמה, xl("A1:Z10", headers=True)מציין שהתאים A1:Z1 הם כותרות.
הערות
-
תוספות יכולות לראות ולקרוא FORMULATEXT הפונקציה PY.
-
הפונקציה PY אינה גלויה בשורת הנוסחאות מאחר שהיא מוצגת באמצעות עורך Python. מוגדר באופן אוטומטי.
-
אין אפשרות להשתמש בפונקציה PY עם פונקציות אחרות של Excel. אם נעשה שימוש עם פונקציות אחרות, לא ניתן להזין נוסחה.
-
הן python_code והןreturn_type הארגומנטים חייבים להיות סטטיים.
דוגמאות
דוגמה 1 משתמשת באופרטור Python plus כדי ליצור "Hello World" מתוך 3 קטעי טקסט.
=PY('Hello' + ' ' + 'World',0)
———————————————————————————
דוגמה 2 משתמשת בפונקציה xl() כדי להשיג את הנתונים מ- Table1 ומחזירה את התוצאה אובייקט Python.
=PY("xl(""Table1[#All]"", headers=True)",1)