PY 函数
Applies To
Microsoft 365 专属 Excel在单元格中输入 =PY 并从“自动完成”菜单中选择 PY 函数后,单元格编辑体验将转换为 Python 编辑器。 若要了解详细信息,请参阅 Excel 中的 Python 简介 和 Excel 中的 Python 入门。
重要: 无法直接从 Excel 的编辑栏中输入或查看 PY 函数,而 Python 编辑器将生成它并将其插入单元格中。 PY 函数语法主要由 addins 用来插入或读取 Python 公式。 在包含 Python 公式的单元格上使用 FORMULATEXT 函数时,也可以看到它。
语法
PY 函数在安全的 Microsoft Cloud 运行时上运行 Python 代码。 结果以 Python 对象或 Excel 值的形式返回。 以下语法
=PY (python_code,return_type)
参数 |
说明 |
python_code (必需) |
在安全的 Microsoft Cloud 运行时上运行的 Python 代码。 必须是静态文本。 |
return_type (必需) |
指定所需的返回类型。 必须是静态数字 0 或 1。
|
Excel 参考
Python 代码可以使用自定义 Python 函数引用 Excel 中的值 xl().
xl()函数支持引用以下 Excel 对象。
-
范围
-
名称
-
表格
-
Power Query连接
xl() 函数支持可选的 headers 参数。 headers 参数指定第一行是否具有标题。 例如, xl("A1:Z10", headers=True)指示单元格 A1:Z1 是标头。
备注
-
可以通过FORMULATEXT查看 PY 函数,并通过加载项进行写入和读取。
-
PY 函数在 编辑栏中不可见 ,因为它使用 Python 编辑器显示。 自动设置。
-
PY 函数不能与任何其他 Excel 函数一起使用。 如果与其他函数一起使用,则无法输入公式。
-
python_code和return_type参数都必须是静态的。
示例
示例 1 使用 Python 加运算符从 3 个文本片段生成“Hello World”。
=PY('Hello' + ' ' + 'World',0)
———————————————————————————
示例 2 使用 xl() 函数从 Table1 获取数据,并将结果作为 Python 对象返回。
=PY("xl(""Table1[#All]"", headers=True)",1)