在儲存格中輸入 =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 引數。 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)