セルに =PY と入力し、オートコンプリート メニューから PY 関数を選択すると、セル編集エクスペリエンスが Python エディターに変わります。 詳細については、「 Python in Excel の概要 」と「 Python in Excel の使用を開始する」を参照してください。
重要
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 関数を使用して 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 plus 演算子を使用して、3 つのテキスト フラグメントから "Hello World" を生成します。
=PY('Hello' + ' ' + 'World',0)
———————————————————————————
例 2 では、 xl() 関数を使用して Table1 からデータを取得し、結果を Python オブジェクトとして返します。
=PY("xl(""Table1[#All]"", headers=True)",1)