Funcția PY

Se aplică la
Excel pentru Microsoft 365 Excel pentru Microsoft 365 pentru Mac

După ce introduceți =PY într-o celulă și selectați funcția PY din meniul de Completare automată, experiența de editare a celulei se transformă într-un editor Python. Pentru a afla mai multe, consultați Introducere în Python în Excel și Introducere în Python în Excel. 

Important

Funcția PY nu poate fi introdusă sau vizualizată direct din bara de formule Excel, ci editorul Python o va genera și o va insera în celulă pentru dvs. Sintaxa funcției PY este utilizată în principal de programele de completare pentru a insera sau a citi direct formule Python. De asemenea, poate fi văzut atunci când utilizați funcția FORMULATEXT pe o celulă care conține o formulă Python. 

Sintaxă

Funcția PY rulează cod Python pe un runtime Microsoft Cloud securizat. Rezultatul este returnat ca obiect Python sau ca valoare Excel. 

=PY(python_code;return_type) 

Argument Descriere
python_code
(obligatoriu)		 Codul Python să ruleze pe un runtime Microsoft Cloud securizat. Trebuie să fie text static.
return_type
(obligatoriu)		 Specificați tipul de returnare dorit. Trebuie să fie un număr static 0 sau 1.
  • 0 indică o valoare Excel.
  • 1 indică obiectul Python.

Referințe Excel

Codul Python poate face referire la valori din Excel utilizând funcția Python particularizată xl().  

Funcția xl() acceptă referirea la următoarele obiecte Excel.

  • Zone
  • Nume
  • Tabele
  • Imagini
  • Conexiuni Power Query

Funcția xl() acceptă un argument antet opțional. Argumentul anteturi specifică dacă primul rând are anteturi. De exemplu, xl("A1:Z10", headers=True) indică faptul că celulele A1:Z1 sunt anteturi. 

Observații

  • Funcția PY poate fi văzută de FORMULATEXT și scrisă și citită de programele de completare.
  • Funcția PY nu este vizibilă în bara de formule , așa cum se afișează utilizând editorul Python. 
  • Funcția PY nu poate fi utilizată cu nicio altă funcție Excel. Dacă se utilizează cu alte funcții, nu se poate introduce o formulă.
  • Atât argumentul python_code , cât și argumentul return_type trebuie să fie statice.

Exemple

Exemplul 1 utilizează operatorul plus Python pentru a genera "Salut lume" din 3 fragmente de text. 

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

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

Exemplul xl() 2 utilizează funcția pentru a obține datele din Tabel1 și returnează rezultatul ca obiect Python. 

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