PY 函数

在单元格中输入 =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。

Python 代码可以使用自定义 Python 函数引用 Excel 中的值 xl().

xl()函数支持引用以下 Excel 对象。

xl() 函数支持可选的 headers 参数。 headers 参数指定第一行是否具有标题。例如， xl("A1:Z10", headers=True)指示单元格 A1：Z1 是标头。

示例 1 使用 Python 加运算符从 3 个文本片段生成“Hello World”。

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

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

示例 2 使用 xl() 函数从 Table1 获取数据，并将结果作为 Python 对象返回。

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