PY-funktio

Käytetään kohteeseen
Excel for Microsoft 365 Excel for Microsoft 365 for Mac

Kun olet kirjoittanut soluun =PY-funktion ja valinnut PY-funktion Automaattinen täydennys -valikosta, solun muokkauskokemus muuttuu Python-editoriksi. Lisätietoja on artikkelissa Johdanto Pythoniin Excelissä ja Pythonin käytön aloittaminen Excelissä. 

Tärkeää

PY-funktiota ei voi syöttää tai nähdä suoraan Excelin kaavariviltä, vaan Python-editori luo sen ja lisää sen soluun puolestasi. Apuohjelmat käyttävät PY-funktion syntaksia pääasiassa Python-kaavojen suoraan lisäämiseen tai lukemiseen. Se näkyy myös, kun KAAVA.TEKSTI-funktiota käytetään solussa, joka sisältää Python-kaavan. 

Syntaksi

PY-funktio suorittaa Python-koodia suojatussa Microsoft Cloudin suorituksenpalvelussa. Tulos palautetaan joko Python-objektina tai Excel-arvona. 

=PY(python_code;return_type) 

Argumentti Kuvaus
python_code
(pakollinen)		 Python-koodi, joka suoritetaan suojatussa Microsoft Cloudin suorituksenpalvelussa. Tekstin on oltava staattista tekstiä.
return_type
(pakollinen)		 Määritä haluamasi palautustyyppi. Numeron on oltava staattinen luku 0 tai 1.
  • 0 osoittaa Excel-arvon.
  • 1 osoittaa Python-objektin.

Excel-viitteet

Python-koodi voi viitata Excelin arvoihin mukautetun Python-funktion avulla xl().  

Funktio xl() tukee viittauksia seuraaviin Excel-objekteihin.

  • Alueet
  • Nimet
  • Taulukot
  • Kuvat
  • Power Query -yhteydet

Funktio xl() tukee valinnaista otsikkoargumenttia. Otsikkoargumentti määrittää, onko ensimmäisellä rivillä otsikot. Osoittaa esimerkiksi xl("A1:Z10", headers=True) , että solut A1:Z1 ovat otsikoita. 

Huomautuksia

  • KAAVA.TEKSTI näkee PY-funktion ja apuohjelmat kirjoittavat ja lukevat PY-funktion.
  • PY-funktio ei näy kaavarivillä , sillä se näytetään Python-editorissa. 
  • PY-funktiota ei voi käyttää muiden Excel-funktioiden kanssa. Jos sitä käytetään muiden funktioiden kanssa, kaavaa ei voi kirjoittaa.
  • Sekä python_code - että return_type-argumenttien on oltava staattisia.

Esimerkkejä

Esimerkissä 1 käytetään Python plus -operaattoria luomaan "Hei maailma" kolmesta tekstikatkelmasta. 

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

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

Esimerkissä 2 funktiolla xl() noudetaan tiedot taulukosta Taulukko1 ja palautetaan tulos Python-objektina. 

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