الدالة PY
Applies To
Excel لـ Microsoft 365استخدم الدالة PY للوصول إلى Python في Excel من شبكة Microsoft 365 Excel.
هام: بعد إدخال =PY في خلية وتحديد الدالة PY من قائمة الإكمال التلقائي، تتحول تجربة تحرير الخلية إلى محرر Python. لمعرفة المزيد، راجع مقدمة حول Python في Excelوبدء استخدام Python في Excel.
بناء الجملة
تقوم الدالة PY بتشغيل تعليمة Python البرمجية في وقت تشغيل Microsoft Cloud آمن. يتم إرجاع النتيجة إما كعنصر Python أو قيمة Excel.
=PY(python_code,return_type)
الوسيطة |
الوصف |
python_code (مطلوب) |
التعليمة البرمجية Python لتشغيلها في وقت تشغيل Microsoft Cloud آمن. يجب أن يكون نصا ثابتا. |
return_type (مطلوب) |
حدد نوع الإرجاع المطلوب. يجب أن يكون رقما ثابتا 0 أو 1.
|
مراجع Excel
يمكن أن تشير التعليمات البرمجية Python إلى القيم في Excel باستخدام دالة Python المخصصة xl().
تدعم الدالةxl()الرجوع إلى عناصر Excel التالية.
-
نطاقات
-
أسماء
-
الجداول
-
اتصالات Power Query
تدعم الدالة xl() وسيطة عناوين اختيارية. تحدد وسيطة الرؤوس ما إذا كان الصف الأول يحتوي على رؤوس. على سبيل المثال، يشير xl("A1:Z10", headers=True)إلى أن الخلايا A1:Z1 هي رؤوس.
ملاحظات
-
لا يمكن استخدام الدالة PY مع أي دالات Excel أخرى. إذا تم استخدامه مع دالات أخرى، فلا يمكن إدخال صيغة.
-
يمكن رؤية الدالة PY بواسطة FORMULATEXT وكتابتها وقراءتها بواسطة الوظائف الإضافية.
-
يجب أن تكون الوسيطتانpython_code return_type ثابتة.
أمثلة
يستخدم المثال 1 عامل تشغيل Python plus لإنشاء "مرحبًا بالعالم" من 3 أجزاء نصية.
=PY('Hello' + ' ' + 'World',0)
———————————————————————————
يستخدم المثال 2 الدالة xl() للحصول على البيانات من Table1 وإرجاع النتيجة كعنصر Python.
=PY("xl(""Table1[#All]"", headers=True)",1)