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