Функция 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. Должен быть статическим текстом.
return_type
(обязательно)		 Укажите требуемый тип возвращаемого значения. Должно быть статическое число 0 или 1.
  • 0 указывает значение Excel.
  • 1 обозначает объект Python.

Ссылки на Excel

Код Python может ссылаться на значения в Excel с помощью пользовательской функции Python xl().  

Функция xl() поддерживает ссылки на следующие объекты Excel.

  • Диапазоны
  • Имена
  • Таблицы
  • Изображения
  • Подключения Power Query

Функция xl() поддерживает необязательный аргумент headers. Аргумент headers указывает, содержит ли первая строка заголовки. Например, указывает, xl("A1:Z10", headers=True) что ячейки A1:Z1 являются заголовками. 

Замечания

  • Функция PY может быть видна с помощью FORMULATEXT , а также написана и считывается надстройками.
  • Функция PY не отображается в строке формул , так как она отображается в редакторе Python. 
  • Функцию PY нельзя использовать с другими функциями Excel. Если используется с другими функциями, формула не может быть введена.
  • Аргументы python_code и return_type должны быть статическими.

Примеры

В примере 1 оператор Python plus используется для создания "Hello World" из трех текстовых фрагментов. 

=PY('Hello' + ' ' + 'World',0) 

 ———————————————————————————

В примере 2 функция используется xl() для получения данных из Table1 и возвращает результат в виде объекта Python. 

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