PY 函數
Applies To
在儲存格中輸入 =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 函式 xl().來參考 Excel 中的值
xl()函式支援參考下列Excel物件。
-
範圍
-
名稱
-
表格
-
圖像
-
Power Query 連線
xl() 函式支援選擇性標頭引數。 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)