PY-funktio

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

Kun olet kirjoittanut =PY soluun 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ää suoraan tai nähdä Excelin kaavariviltä, vaan Python-editori luo sen ja lisää sen soluun puolestasi. PY-funktion syntaksia käytetään pääasiassa apuohjelmissa Python-kaavojen suoraan lisäämiseen tai lukemiseen. Se näkyy myös käytettäessä FORMULATEXT-funktiota python-kaavan sisältävässä solussa. 

Syntaksi

PY-funktio suorittaa Python-koodin suojatussa MicrosoftIn pilvipalvelussa. Tulos palautetaan joko Python-objektina tai Excel-arvona. 

=PY(python_code,return_type) 

Argumentti Kuvaus
python_code
(pakollinen)		 Python-koodi, joka suoritetaan suojatulla MicrosoftIn pilvipalvelulla. Tekstin on oltava staattista.
return_type
(pakollinen)		 Määritä haluamasi palautustyyppi. Arvon on oltava staattinen luku 0 tai 1.
  • 0 osoittaa Excel-arvon.
  • 1 tarkoittaa Python-objektia.

Excel-viittaukset

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

Funktio xl() tukee seuraaviin Excel-objekteihin viittaamista.

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

Funktio xl() tukee valinnaista otsikkoargumenttia. Otsikko-argumentti määrittää, onko ensimmäisellä rivillä otsikot. Tämä tarkoittaa esimerkiksi sitä, xl("A1:Z10", headers=True) että solut A1:Z1 ovat otsikoita. 

Huomautuksia

  • PY-funktio näkyy KAAVATEKSTI-funktiolla, ja apuohjelmat kirjoittavat ja lukevat sen.
  • PY-funktio ei näy kaavarivillä , koska se näkyy Python-editorin avulla. 
  • PY-funktiota ei voi käyttää muiden Excel-funktioiden kanssa. Jos kaavaa käytetään muiden funktioiden kanssa, sitä ei voi kirjoittaa.
  • Sekä python_code että return_type argumenttien on oltava staattisia.

Esimerkkejä

Esimerkki 1 käyttää Python plus -operaattoria luodakseen "Hei maailma" kolmesta tekstiosasta. 

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

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

Esimerkki 2 hakee tiedot taulukosta 1 funktion xl() avulla ja palauttaa tuloksen Python-objektina. 

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