Pythonコードをセル内で実行できるPY関数 - まうにゃんのエクセル講座

PY関数は、PythonコードをExcelのセル内で実行できる関数です。
「Python in Excel」と呼ばれたりしています。

実際の計算は Microsoft クラウドで実行され結果がワークシートに返されます。

セルに=PYと入力し、オートコンプリートメニューからPY関数を選択すると、セル編集エクスペリエンスがPythonエディターに変換されます。
PY関数は、セキュリティで保護されたMicrosoft CloudランタイムでPythonコードを実行し、結果をPythonオブジェクトまたはExcel値として返します。

PY関数の構文

=PY(python_code,return_type)

引数	説明
python_code	必須セキュリティで保護された Microsoft Cloud ランタイムで実行する Python コード。静的テキストである必要があります。
return_type	必須目的の戻り値の型を指定します。 0 は Excel 値を示します。 1 は Python オブジェクトを示します。

PY関数は他のExcel関数では使用できません。
PY関数はFORMULATEXT関数によって表示できます。

return_type

セルにPY関数を手動入力していく時点で指定することが出来ないようです。
（方法があるかもしれませんが、現時点で筆者には分かりません）
関数を入れ終わった後で、

このひし形のアイコンをクリックして、
・Python オブジェクト
・Excel の値
これらを選択できます。
Python オブジェクト → return_type=1
Excel の値 → return_type=0

Excel 参照

Pythonコードでは、xl()関数（カスタム Python 関数）を使用してExcelの値を参照します。
xl()関数では、以下の参照がサポートされています。
・範囲
・名前
・テーブル
・接続のPower Query
xl() 関数では、省略可能な headers 引数がサポートされています。
headers 引数は、最初の行にヘッダーがあるかどうかを指定します。