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. Резултатът се връща като обект на Python или като стойност на Excel. 

=PY(python_code;return_type) 

Аргумент Описание
python_code
(задължително)		 Кодът на Python за изпълнение в защитена среда на изпълнение в облака на Microsoft. Трябва да е статичен текст.
return_type
(задължително)		 Задайте желания тип връщане. Трябва да е статично число, 0 или 1.
  • 0 указва стойност на Excel.
  • 1 показва обект на Python.

Препратки към 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)