PY 函數
Applies To
Microsoft 365 Excel使用 PY 函數從 Microsoft 365 Excel 方格存取 Excel 中的 Python。
重要: 在儲存格中輸入 =PY 並 從 [自動完成] 選單選取 PY 函數之後,儲存格編輯體驗會轉換成 Python 編輯器。 若要深入瞭解,請參閱 Excel 中的 Python 簡介 和 Excel 中的 Python 快速入門。
語法
PY 函數會在安全Microsoft雲端運行時間上執行 Python 程式代碼。 結果會以 Python 物件或 Excel 值的形式傳回。
=PY (python_code,return_type)
引數 |
描述 |
python_code (必要) |
可在安全Microsoft雲端運行時間執行的 Python 程式代碼。 必須是靜態文字。 |
return_type (必要) |
指定想要的退貨類型。 必須是靜態數位 0 或 1。
|
Excel 參照
Python 程式代碼可以使用自定義的 Python 函數來參照 Excel 中的值 xl().
xl()函數支持參照下列 Excel 物件。
-
範圍
-
名稱
-
表格
-
Power Query 連線
xl() 函數支持選用的頁首自變數。 標題自變數會指定第一列是否有標題。 例如, xl("A1:Z10", headers=True)表示 儲存格 A1:Z1 是標題。
註解
-
PY 函數無法搭配任何其他 Excel 函數使用。 如果與其他函數搭配使用,則無法輸入公式。
-
FORMULATEXT 可看到 PY 函數,並使用載入巨集撰寫和讀取。
-
python_code和return_type自變數都必須是靜態的。
範例
範例 1 使用 Python 加號運算子從 3 個文字片段產生「Hello World」。
=PY('Hello' + ' ' + 'World',0)
———————————————————————————
範例 2 使用 xl() 函數從 Table1 取得數據,並將結果傳回為 Python 物件。
=PY("xl(""Table1[#All]"", headers=True)",1)