Funkcja PY

Dotyczy
Excel dla Microsoft 365 Excel dla Microsoft 365 dla komputerów Mac

Po wprowadzeniu formuły =PY w komórce i wybraniu funkcji PY z menu Autouzupełnianie środowisko edycji komórek przekształca się w edytor w języku Python. Aby dowiedzieć się więcej, zobacz Wprowadzenie do języka Python w programie Excel i Wprowadzenie do usługi Python w programie Excel. 

Ważne

Funkcji PY nie można bezpośrednio wprowadzić ani wyświetlić z paska formuły programu Excel, zamiast tego edytor w języku Python wygeneruje ją i wstawi do komórki za Ciebie. Składnia funkcji PY jest używana głównie przez dodatki do bezpośredniego wstawiania lub odczytywania formuł w języku Python. Można to również zobaczyć podczas korzystania z funkcji FORMUŁA.TEKST w komórce zawierającej formułę w języku Python. 

Składnia

Funkcja PY uruchamia kod w języku Python w bezpiecznym środowisku uruchomieniowym Microsoft Cloud. Wynik jest zwracany jako obiekt w języku Python lub wartość programu Excel. 

=PY(python_code;return_type) 

Argument Opis
python_code
(wymagane)		 Kod w języku Python, który ma być uruchamiany w bezpiecznym środowisku uruchomieniowym chmury firmy Microsoft. Musi to być tekst statyczny.
Zwracany_typ
(wymagane)		 Określ żądany typ zwrotu. Musi to być liczba statyczna 0 lub 1.
  • Wartość 0 oznacza wartość programu Excel.
  • 1 oznacza obiekt Pythona.

Odwołania do programu Excel

Kod w języku Python może odwoływać się do wartości w programie Excel przy użyciu niestandardowej funkcji języka Python xl().  

Ta xl() funkcja obsługuje odwoływanie się do następujących obiektów programu Excel.

  • Zakresy
  • Nazwy
  • Tabele
  • Obrazy
  • Power Query połączeń

Ta xl() funkcja obsługuje opcjonalny argument nagłówków. Argument nagłówki określa, czy pierwszy wiersz ma nagłówki. Na przykład wskazuje, xl("A1:Z10", headers=True) że komórki A1:Z1 są nagłówkami. 

Spostrzeżenia

  • Funkcja PY jest widoczna w formule TEKST oraz jest zapisywana i odczytywana przez dodatki.
  • Funkcja PY nie jest widoczna na pasku formuły , ponieważ jest wyświetlana za pomocą edytora w języku Python. 
  • Funkcji PY nie można używać z żadnymi innymi funkcjami programu Excel. Jeśli jest używana z innymi funkcjami, nie można wprowadzić formuły.
  • Zarówno argumenty python_code , jak i return_type muszą być statyczne.

Przykłady

W przykładzie 1 operator Plus w języku Python generuje "Hello world" z 3 fragmentów tekstu. 

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

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

W przykładzie 2 użyto tej xl() funkcji do uzyskania danych z tabeli Table1 i zwrócenia wyniku jako obiektu w języku Python. 

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