Applies ToExcel для Microsoft 365

После ввода =PY в ячейку и выбора функции PY в меню Автозаполнения процесс редактирования ячейки преобразуется в редактор Python. Дополнительные сведения см. в статьях Введение в Python в Excel и Начало работы с Python в Excel

Важно: Невозможно напрямую ввести или увидеть функцию PY из строки формул Excel. Вместо этого редактор Python создаст ее и вставляет в ячейку. Синтаксис функции PY в основном используется надстройками для вставки или чтения формул Python. Это также можно увидеть при использовании функции Ф.ТЕКСТ в ячейке, содержащей формулу 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 может быть видна Ф.ТЕКСТ, а также написана и считывается надстройками.

  • Функция PY не отображается в строке формул , так как она отображается в редакторе Python.  устанавливается автоматически. 

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

  • Аргументы python_code и return_type должны быть статическими.

Примеры 

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

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

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

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

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

Нужна дополнительная помощь?

Нужны дополнительные параметры?

Изучите преимущества подписки, просмотрите учебные курсы, узнайте, как защитить свое устройство и т. д.

В сообществах можно задавать вопросы и отвечать на них, отправлять отзывы и консультироваться с экспертами разных профилей.