在单元格中输入 =PY 并从“自动完成”菜单中选择 PY 函数后，单元格编辑体验将转换为 Python 编辑器。 若要了解详细信息，请参阅 Excel 中的 Python 简介 和 Excel 中的 Python 入门。
重要
PY 函数无法直接从 Excel 的编辑栏输入或查看，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 参数。 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)