PY 関数
Applies To
Excel for Microsoft 365PY 関数を使用して、Microsoft 365 Excel グリッドから Excel の Python にアクセスします。
重要: セルに =PY と入力し、オートコンプリート メニューから PY 関数を選択すると、セル編集エクスペリエンスが Python エディターに変換されます。 詳細については、「 Excel での Python の概要」と「Excel でのPython の概要」を参照してください。
構文
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 関数は、他の Excel 関数では使用できません。 他の関数と共に使用する場合は、数式を入力できません。
-
PY 関数は FORMULATEXT によって表示され、アドインによって書き込まれ、読み取られます。
-
python_code引数とreturn_type引数の両方を静的にする必要があります。
例
例 1 では、Python plus 演算子を使用して、3 つのテキスト フラグメントから "Hello World" を生成します。
=PY('Hello' + ' ' + 'World',0)
———————————————————————————
例 2 では、 xl() 関数を使用して Table1 からデータを取得し、その結果を Python オブジェクトとして返します。
=PY("xl(""Table1[#All]"", headers=True)",1)