Po wprowadzeniu =PY do komórki i wybraniu funkcji PY z menu Autouzupełnianie, środowisko edycji komórek przekształca się w edytor Python. Aby dowiedzieć się więcej, zobacz Wprowadzenie do języka Python w programie Excel i Wprowadzenie do języka Python w programie Excel.
Ważne
Funkcji PY nie można bezpośrednio wprowadzić ani zobaczyć z paska formuły programu Excel, zamiast tego edytor Python wygeneruje ją i wstawi do komórki. Składnia funkcji PY jest używana głównie przez dodatki do bezpośredniego wstawiania lub odczytywania formuł języka Python. Można to również zobaczyć podczas używania funkcji FORMUŁA.TEKST na komórce zawierającej formułę Pythona.
Składnia
Funkcja PY uruchamia kod w języku Python w bezpiecznym środowisku uruchomieniowym chmury firmy Microsoft. Wynik jest zwracany jako obiekt języka Python lub wartość programu Excel.
=PY(python_code;return_type)
| Argument | Opis |
|---|---|
|
python_code (wymagane) |
Kod w języku Python do uruchamiania w bezpiecznym środowisku uruchomieniowym chmury firmy Microsoft. Musi to być tekst statyczny. |
|
return_type (wymagane) |
Określ żądany zwracany typ. Musi to być liczba statyczna 0 lub 1.
|
Odwołania 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
- Połączenia dodatku Power Query
Ta xl() funkcja obsługuje opcjonalny argument nagłówków. Argument nagłówki określa, czy pierwszy wiersz zawiera nagłówki. Na xl("A1:Z10", headers=True) przykład wskazuje, że komórki A1:Z1 są nagłówkami.
Spostrzeżenia
- Funkcja PY może być widoczna w funkcji FORMUŁA.TEKST oraz pisana i odczytywana w dodatkach.
- Funkcja PY nie jest widoczna na pasku formuły , ponieważ jest wyświetlana za pomocą edytora Python.
- Funkcji PY nie można używać z innymi funkcjami programu Excel. Formuła używana z innymi funkcjami nie może zostać wprowadzona.
- Argumenty python_code i return_type muszą być statyczne.
Przykłady
W przykładzie 1 użyto operatora Python plus do wygenerowania "Hello world" z 3 fragmentów tekstu.
=PY('Hello' + ' ' + 'World',0)
———————————————————————————
W przykładzie 2 użyto xl() funkcji w celu uzyskania danych z tabeli Table1 i zwrócenia wyniku jako obiektu języka Python.
=PY("xl(""Table1[#All]"", headers=True)",1)