在单元格中输入 =PY 并从“自动完成”菜单中选择 PY 函数后，单元格编辑体验将转换为 Python 编辑器。 若要了解详细信息，请参阅 Excel 中的 Python 简介 和 Excel 中的 Python 入门。
重要
无法直接从 Excel 的编辑栏中输入或查看 PY 函数，而 Python 编辑器将生成它并将其插入单元格中。 PY 函数语法主要由加载项用来直接插入或读取 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 参数指定第一行是否具有标题。 例如， xl("A1:Z10", headers=True) 指示单元格 A1：Z1 是标头。
备注
- PY 函数可以通过 FORMULATEXT 查看，并由加载项编写和读取。
- 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)