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 aus dem AutoVervollständigen-Menü ausgewählt haben, verwandelt sich die Zellbearbeitung in einen Python-Editor. 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 in der Excel-Bearbeitungsleiste eingegeben oder angezeigt werden, stattdessen generiert der Python-Editor sie und fügt sie für Sie in die Zelle ein. Die PY-Funktionssyntax wird hauptsächlich von Add-Ins verwendet, um Python-Formeln direkt einzufügen oder zu lesen. Sie kann auch angezeigt werden, wenn die Funktion FORMELTEXT auf einer Zelle verwendet wird, die eine Python-Formel enthält. 

Syntax

Die PY-Funktion führt Python-Code in einer sicheren Microsoft Cloud-Laufzeit 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 in 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 sein: 0 oder 1.
  • 0 gibt einen Excel-Wert an.
  • 1 gibt das Python-Objekt an.

Excel-Referenzen

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 Header enthält. Gibt xl("A1:Z10", headers=True) beispielsweise an, dass die Zellen A1:Z1 Überschriften sind. 

Hinweise

  • Die PY-Funktion kann von FORMELTEXT erkannt 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 das python_code - als auch das return_type-Argument müssen statisch sein.

Beispiele

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

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

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

Beispiel 2 verwendet die xl() Funktion zum Abrufen der Daten aus Tabelle1 und gibt das Ergebnis als Python-Objekt zurück. 

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