Funktsioon PY

Rakenduskoht
Microsoft 365 rakendus Excel Maci jaoks ette nähtud Microsoft 365 rakendus Excel

Pärast =PY sisestamist lahtrisse ja funktsiooni PY valimist automaatteksti menüüst muudetakse lahtri redigeerimine Pythoni redaktoriks. Lisateavet leiate teemadest Excelis Pythoni tutvustus ja Pythoni kasutamise alustamine Excelis. 

NB!

Funktsiooni PY ei saa otse Exceli valemiribale sisestada ega kuvada, vaid Pythoni redaktor genereerib selle ja lisab selle teie eest lahtrisse. Funktsiooni PY süntaksit kasutavad lisandmoodulid peamiselt Pythoni valemite otsesisestamiseks või lugemiseks. Seda võib näha ka funktsiooni FORMULATEXT kasutamisel Pythoni valemit sisaldavas lahtris. 

Süntaks

Funktsioon PY käitab Pythoni koodi turvalisel Microsofti pilve käitusajal. Tulem tagastatakse Pythoni objektina või Exceli väärtusena. 

=PY(python_code;return_type) 

Argument Kirjeldus
python_code
(nõutav)		 Pythoni kood, mida käitada turvalises Microsofti pilvteenuse käitusajas. Peab olema staatiline tekst.
return_type
(nõutav)		 Määrake soovitud tagastustüüp. Peab olema staatiline arv 0 või 1.
  • 0 tähistab Exceli väärtust.
  • 1 tähistab Pythoni objekti.

Exceli viited

Pythoni kood saab Excelis väärtustele viidata kohandatud Pythoni funktsiooni abil xl().  

Funktsioon xl() toetab järgmiste Exceli objektide viitamist.

  • Vahemikud
  • Names
  • Tabelid
  • Pildid
  • Power Query ühendused

Funktsioon xl() toetab valikuliste päiste argumenti. Päiseargument määrab, kas esimesel real on päised. Näiteks näitab see, xl("A1:Z10", headers=True) et lahtrid A1:Z1 on päised. 

Kommentaarid

  • Funktsiooni PY näeb FORMULATEXT ning selle on kirjutanud ja lugenud lisandmoodulid.
  • Funktsioon PY pole valemiribal nähtav , kuna see kuvatakse Pythoni redaktoris. 
  • Funktsiooni PY ei saa kasutada ühegi teise Exceli funktsiooniga. Kui seda kasutatakse koos muude funktsioonidega, ei saa valemit sisestada.
  • Argumendid python_code ja return_type peavad olema staatilised.

Näited

Näites 1 kasutatakse tehtemärki Python plussmärgiga "Tere, maailm!" genereerimiseks kolmest tekstifragmendist. 

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

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

Näites xl() 2 kasutatakse funktsiooni andmete toomiseks tabelist Table1 ja tagastatakse tulem Pythoni objektina. 

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