PY, functie

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

Nadat je =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 PY-functie kan niet rechtstreeks worden ingevoerd of weergegeven via de formulebalk van Excel, maar de Python-editor genereert deze en voegt deze voor je in de cel in. De syntaxis van de PY-functie wordt voornamelijk gebruikt door invoegtoepassingen om Python-formules direct in te voegen of te lezen. Dit is ook zichtbaar wanneer u de functie FORMULETEKST gebruikt in een cel met een Python-formule. 

Syntaxis

Met de PY-functie wordt Python-code uitgevoerd 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 in een beveiligde Microsoft Cloud-runtime. Moet statische tekst zijn.
return_type
(vereist)		 Geef het gewenste retourtype op. Dit moet een statisch getal 0 of 1 zijn.
  • 0 geeft de Excel-waarde aan.
  • 1 geeft 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 verwijzingen naar de volgende Excel-objecten.

  • Bereiken
  • Namen
  • Tabellen
  • Afbeeldingen
  • Verbindingen voor Power Query

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

Opmerkingen

  • De functie PY kan worden gezien door FORMULETEKST en worden geschreven en gelezen door invoegtoepassingen.
  • De functie PY is niet zichtbaar op de formulebalk , aangezien deze wordt weergegeven met de Python-editor. 
  • De functie PY kan niet worden gebruikt met andere Excel-functies. Bij gebruik met andere functies kan een formule niet worden ingevoerd.
  • Zowel het python_code als het return_type argument moeten statisch zijn.

Voorbeelden

Voorbeeld 1 gebruikt de Python plus-operator om 'Hallo wereld' te genereren uit 3 tekstfragmenten. 

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

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

In voorbeeld 2 wordt de xl() functie gebruikt om de gegevens op te halen uit Tabel1 en wordt het resultaat geretourneerd in de vorm van een Python-object. 

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