PY-Funktion

Gilt für
Excel für Microsoft 365 Excel für Microsoft 365 für Mac

Nachdem Sie =PY in eine Zelle eingegeben und die PY-Funktion im Menü AutoVervollständigen ausgewählt haben, wird die Zellbearbeitung in einen Python-Editor umgewandelt. Weitere Informationen finden Sie unter Einführung in Python in Excel und Erste Schritte mit Python in Excel

Wichtig

Die PY-Funktion kann nicht direkt über die Bearbeitungsleiste von Excel eingegeben oder angezeigt werden. Stattdessen generiert der Python-Editor sie und fügt sie für Sie in die Zelle ein. Die Syntax der Funktion PY wird hauptsächlich von Add-Ins verwendet, um Python-Formeln direkt einzufügen oder zu lesen. Dies kann auch angezeigt werden, wenn die FORMULATEXT-Funktion in einer Zelle verwendet wird, die eine Python-Formel enthält. 

Syntax

Die PY-Funktion führt Python-Code in einer sicheren Microsoft Cloud Runtime aus. Das Ergebnis wird entweder als Python-Objekt oder als Excel-Wert zurückgegeben. 

=PY(python_code;return_type) 

Argument Beschreibung
python_code
(erforderlich)
Der Python-Code, der auf einer sicheren Microsoft Cloud-Runtime ausgeführt werden soll. Muss statischer Text sein.
return_type
(erforderlich)
Geben Sie den gewünschten Rückgabetyp an. Muss eine statische Zahl 0 oder 1 sein.
  • 0 gibt den Excel-Wert an.
  • 1 gibt das Python-Objekt an.

Excel-Verweise

Der Python-Code kann mithilfe der benutzerdefinierten Python-Funktion auf Werte in Excel verweisen. xl().  

Die xl() Funktion unterstützt das Verweisen auf die folgenden Excel-Objekte.

  • Bereiche
  • Namen
  • Tabellen
  • Bilder
  • Power Query-Verbindungen

Die xl() Funktion unterstützt ein optionales Headerargument. Das headers-Argument gibt an, ob die erste Zeile Kopfzeilen enthält. Gibt beispielsweise an, xl("A1:Z10", headers=True) dass die Zellen A1:Z1 Header sind. 

Hinweise

  • Die PY-Funktion kann von FORMULATEXT gesehen und von Add-Ins geschrieben und gelesen werden.
  • Die PY-Funktion ist in der Bearbeitungsleiste nicht sichtbar , da sie mit dem Python-Editor angezeigt wird. 
  • Die PY-Funktion kann nicht mit anderen Excel-Funktionen verwendet werden. Bei Verwendung mit anderen Funktionen kann keine Formel eingegeben werden.
  • Sowohl die Argumente python_code als auch return_type müssen statisch sein.

Beispiele

Beispiel 1 verwendet den Python plus-Operator, um "Hallo Welt" aus drei Textfragmenten zu generieren. 

=PY('Hello' + ' ' + 'World',0) 

 ———————————————————————————

Beispiel 2 verwendet die xl() -Funktion, um die Daten aus Table1 abzurufen, und gibt das Ergebnis als Python-Objekt zurück. 

=PY("xl(""Table1[#All]"", headers=True)",1)