Funkce PY

Platí pro
Excel pro Microsoft 365 Excel pro Microsoft 365 pro Mac

Po zadání =PY do buňky a výběru funkce PY v nabídce automatického dokončování se prostředí úprav buňky změní na editor Pythonu. Další informace najdete v tématech Úvod do Pythonu v Excelu a Začínáme s Pythonem v Excelu

Důležité

Funkci PY nelze přímo zadat ani zobrazit z řádku vzorců Excelu, místo toho ji vygeneruje editor Pythonu a vloží ji do buňky za vás. Syntaxi funkce PY primárně používají doplňky k přímému vkládání nebo čtení vzorců Pythonu. Je to vidět také při použití funkce FORMULATEXT v buňce obsahující vzorec Pythonu. 

Syntaxe

Funkce PY spouští kód Pythonu v zabezpečeném modulu runtime Microsoft Cloudu. Výsledek se vrátí buď jako objekt Pythonu, nebo jako excelová hodnota. 

=PY(python_code;return_type) 

Argument Popis
python_code
(povinné)
Kód Pythonu pro běh v zabezpečeném modulu runtime Microsoft Cloudu. Musí se jednat o statický text.
return_type
(povinné)
Zadejte požadovaný typ vrácení. Musí jít o statické číslo 0 nebo 1.
  • 0 označuje hodnotu v Excelu.
  • 1 označuje objekt Pythonu.

Odkazy na Excel

Kód Pythonu může odkazovat na hodnoty v Excelu pomocí vlastní funkce Pythonu xl().  

Funkce xl() podporuje odkazování na následující objekty aplikace Excel.

  • Rozsahy
  • Názvy
  • Tabulky
  • Obrázky
  • Připojení Power Query

Funkce xl() podporuje nepovinný argument headers. Argument headers určuje, jestli má první řádek záhlaví. Například označuje, xl("A1:Z10", headers=True) že buňky A1:Z1 jsou záhlaví. 

Poznámky

  • Funkci PY může zobrazit funkce FORMULATEXT a zapisovat a číst doplňky.
  • Funkce PY není viditelná v řádku vzorců , protože je zobrazena pomocí editoru Pythonu. 
  • Funkci PY nelze použít s žádnými jinými funkcemi aplikace Excel. Při použití s jinými funkcemi vzorec nelze zadat.
  • Argumenty python_code i return_type musí být statické.

Příklady

Příklad 1 používá operátor plus Pythonu k vygenerování "Hello World" ze 3 fragmentů textu. 

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

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

Příklad 2 používá xl() funkci k získání dat z tabulky1 a vrátí výsledek jako objekt Pythonu. 

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