Функция PY
Applies To
Excel для Microsoft 365Используйте функцию PY для доступа к Python в Excel из сетки Microsoft 365 Excel.
Важно: После ввода =PY в ячейку и выбора функции PY в меню Автозаполнения процесс редактирования ячейки преобразуется в редактор Python. Дополнительные сведения см. в статьях Введение в Python в Excel и Начало работы с Python в Excel.
Синтаксис
Функция PY выполняет код Python в безопасной среде выполнения Microsoft Cloud. Результат возвращается в виде объекта Python или значения Excel.
=PY(python_code;return_type)
Аргумент |
Описание |
python_code (обязательно) |
Код Python для запуска в безопасной облачной среде выполнения Microsoft. Должен быть статическим текстом. |
return_type (обязательно) |
Укажите требуемый тип возвращаемого значения. Должно быть статическое число 0 или 1.
|
Ссылки на Excel
Код Python может ссылаться на значения в Excel с помощью пользовательской функции Python xl().
Функцияxl()поддерживает ссылки на следующие объекты Excel.
-
Диапазоны
-
Имена
-
Таблицы
-
подключения Power Query
Функция xl() поддерживает необязательный аргумент headers. Аргумент headers указывает, содержит ли первая строка заголовки. Например, xl("A1:Z10", headers=True)указывает, что ячейки A1:Z1 являются заголовками.
Замечания
-
Функцию PY нельзя использовать с другими функциями Excel. Если используется с другими функциями, формула не может быть введена.
-
Функция PY может быть видна с помощью FORMULATEXT , а также написана и считывается надстройками.
-
Аргументы python_code и return_type должны быть статическими.
Примеры
В примере 1 оператор Python плюс используется для создания "Hello World" из трех фрагментов текста.
=PY('Hello' + ' ' + 'World',0)
———————————————————————————
В примере 2 функция xl() используется для получения данных из Table1 и возвращает результат в виде объекта Python.
=PY("xl(""Table1[#All]"", headers=True)",1)