在儲存格輸入 =PY 並從自動完成選單中選擇 PY 功能後，儲存格編輯體驗會轉換成 Python 編輯器。 想了解更多，請參閱 《Excel 中的 Python 入門 》和 《Excel 中的 Python 入門》。
重要
PY 函式無法直接從 Excel 的公式列輸入或顯示，Python 編輯器會自動產生並自動插入儲存格。 PY 函式語法主要被外掛程式用來直接插入或讀取 Python 公式。 當使用 FORMULATEXT 函式處理包含 Python 公式的儲存格時，也能看到此現象。
語法
PY 函式在安全的 Microsoft Cloud 執行環境上執行 Python 程式碼。 結果會以 Python 物件或 Excel 值的形式回傳。
=派 (python_code，return_type)
| 引數 | 描述 |
|---|---|
|
python_code (必要) |
Python 程式碼能在安全的 Microsoft Cloud 執行環境上執行。 一定是靜態文字。 |
|
return_type (必要) |
指定想要的回傳類型。 必須是固定的數字0或1。
|
Excel 參考資料
Python 程式碼可透過自訂 Python 函式參考 Excel 中的數值 xl().
此 xl() 函式支援參考以下 Excel 物件。
- 射程
- 名稱
- 表格
- 圖像
- Power Query 連線
此 xl() 函式支援可選的標頭參數。 標頭參數指定第一列是否有標頭。 例如，表示 A1 xl("A1:Z10", headers=True)：Z1 為標頭。
註解
- PY 函式可以透過 FORMULATEXT 看到，並由外掛程式寫入與讀取。
- PY 函式在 公式列中無法顯示 ，因為它是用 Python 編輯器顯示的。
- PY 函數無法與其他 Excel 函式一起使用。 若與其他函數一起使用，則無法輸入公式。
- python_code和return_type論點都必須保持靜態。
範例
範例 1 使用 Python 加運算子從三個文字片段中產生「Hello World」。
=PY('Hello' + ' ' + 'World',0)
———————————————————————————
範例二使用函 xl() 式從 Table1 取得資料，並將結果以 Python 物件回傳。
=PY("xl(""Table1[#All]"", headers=True)",1)