Функция 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() поддерживает необязательный аргумент заголовков. Аргумент заголовков определяет, есть ли в первой строке заголовки. Например, 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() для получения данных из таблицы Table1 и возвращается результат в виде объекта Python. 

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