PY (funkcia)

Vzťahuje sa na
Excel pre Microsoft 365 Excel pre Microsoft 365 pre Mac

Po zadaní =PY do bunky a výbere funkcie PY v ponuke automatického dokončovania sa úprava bunky zmení na editor jazyka Python. Ďalšie informácie nájdete v téme Úvod do Pythonu v Exceli a Začíname s Pythonom v Exceli. 

Dôležité

Funkciu PY nie je možné zadať priamo ani zobraziť zo vzorcového riadka Excelu, namiesto toho ju editor jazyka Python vygeneruje a vloží do bunky za vás. Syntax funkcie PY používajú predovšetkým doplnky na priame vkladanie alebo čítanie vzorcov jazyka Python. Možno to vidieť aj pri použití funkcie FORMULATEXT v bunke, ktorá obsahuje vzorec jazyka Python. 

Syntax

Funkcia PY spúšťa kód jazyka Python v zabezpečenom režime runtime Microsoft Cloud. Výsledok sa vráti ako objekt Pythona alebo ako excelová hodnota. 

=PY(python_code;return_type) 

Argument Popis
python_code
(povinné)		 Kód jazyka Python určený na spustenie v zabezpečenom režime runtime cloudu spoločnosti Microsoft. Musí byť statický text.
return_type
(povinné)		 Zadajte požadovaný typ vrátenia. Musí to byť statické číslo 0 alebo 1.
  • Hodnota 0 označuje excelovú hodnotu.
  • 1 označuje objekt Pythona.

Odkazy na Excel

Kód jazyka Python môže odkazovať na hodnoty v Exceli pomocou vlastnej funkcie jazyka Python xl().  

Funkcia xl() podporuje odkazovanie na nasledujúce objekty programu Excel.

  • Rozsahy
  • Názvy
  • Tabuľky
  • Obrázky
  • Pripojenia Power Query

Funkcia xl() podporuje voliteľný argument hlavičiek. Argument hlavičky určuje, či prvý riadok obsahuje hlavičky. Napríklad označuje, xl("A1:Z10", headers=True) že bunky A1:Z1 sú hlavičky. 

Poznámky:

  • Funkciu PY vidí funkcia FORMULATEXT a doplnky ju môžu zapísať a čítať.
  • Funkcia PY nie je viditeľná v riadku vzorcov , pretože sa zobrazuje pomocou editora jazyka Python. 
  • Funkciu PY nie je možné použiť s inými funkciami Excelu. Ak sa vzorec používa s inými funkciami, nie je možné ho zadať.
  • Argumenty python_code aj return_type musia byť statické.

Príklady

Príklad 1 používa operátor plus Python na vygenerovanie reťazca "Hello World" z 3 fragmentov textu. 

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

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

Príklad 2 používa funkciu xl() na získanie údajov z tabuľky Tabuľka1 a vráti výsledok ako objekt jazyka Python. 

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