PY, functie

Van toepassing op
Excel voor Microsoft 365 Excel voor Microsoft 365 voor Mac

Nadat u =PY in een cel hebt ingevoerd en de functie PY hebt geselecteerd in het menu Automatisch aanvullen, verandert de celbewerkingservaring in een Python-editor. Zie Inleiding tot Python in Excel en Aan de slag met Python in Excel voor meer informatie. 

Belangrijk

De functie PY kan niet rechtstreeks worden ingevoerd of gezien vanuit de formulebalk van Excel. In plaats daarvan genereert de Python-editor deze en voegt deze voor u in de cel in. De syntaxis van de functie PY wordt voornamelijk gebruikt door invoegtoepassingen om Python-formules rechtstreeks in te voegen of te lezen. Dit is ook te zien wanneer u de functie FORMULATEXT gebruikt in een cel met een Python-formule. 

Syntaxis

De py-functie voert Python-code uit op een beveiligde Microsoft Cloud-runtime. Het resultaat wordt geretourneerd als een Python-object of een Excel-waarde. 

=PY(python_code;return_type) 

Argument Beschrijving
python_code
(vereist)
De Python-code die moet worden uitgevoerd op een beveiligde Microsoft Cloud-runtime. Moet statische tekst zijn.
return_type
(vereist)
Geef het gewenste retourtype op. Moet een statisch getal 0 of 1 zijn.
  • 0 geeft de Excel-waarde aan.
  • 1 geeft het Python-object aan.

Excel-verwijzingen

De Python-code kan verwijzen naar waarden in Excel met behulp van de aangepaste Python-functie xl().  

De xl() functie ondersteunt het verwijzen naar de volgende Excel-objecten.

  • Bereiken
  • Namen
  • Tabellen
  • Afbeeldingen
  • Power Query verbindingen

De xl() functie ondersteunt een optioneel argument headers. Het argument headers geeft aan of de eerste rij kopteksten bevat. Geeft bijvoorbeeld xl("A1:Z10", headers=True) aan dat cellen A1:Z1 kopteksten zijn. 

Opmerkingen

  • De functie PY kan worden gezien door FORMULETEKST en geschreven en gelezen door invoegtoepassingen.
  • De functie PY is niet zichtbaar in de formulebalk omdat deze wordt weergegeven met behulp van de Python-editor. 
  • De functie PY kan niet worden gebruikt met andere Excel-functies. Als u met andere functies wordt gebruikt, kan er geen formule worden ingevoerd.
  • Zowel de argumenten python_codeals return_type moeten statisch zijn.

Voorbeelden

Voorbeeld 1 gebruikt de python plus-operator om 'Hallo wereld' te genereren op basis van drie tekstfragmenten. 

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

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

Voorbeeld 2 gebruikt de xl() functie om de gegevens op te halen uit Table1 en retourneert het resultaat als een Python-object. 

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