Функція PY

Застосовується до
Excel для Microsoft 365 Excel для Microsoft 365 для Mac

Після введення =PY у клітинку та вибору функції PY в меню автозаповнення інтерфейс редагування клітинок перетворюється на редактор Python. Докладні відомості див. в статтях Загальні відомості про Python в Excel і Початок роботи з Python в Excel. 

Важливо

Функцію PY не можна ввести безпосередньо або побачити в рядку формул Excel, натомість редактор Python згенерує її та вставить у клітинку за вас. Синтаксис функції PY здебільшого використовується в надбудовах для безпосереднього вставлення або читання формул Python. Це також можна побачити, якщо використовувати функцію FORMULATEXT у клітинці, що містить формулу Python. 

Синтаксис

Функція PY запускає код Python у захищеному середовищі виконання Microsoft Cloud. Результат повертається у вигляді об'єкта Python або значення Excel. 

=PY(python_code;return_type) 

Аргумент Опис
python_code
(обов’язковий)		 Код Python для запуску в захищеному середовищі виконання Microsoft Cloud. Це має бути статичний текст.
return_type
(обов’язковий)		 Укажіть потрібний тип значення, що повертається. Це має бути статичне число 0 або 1.
  • 0 указує на значення Excel.
  • 1 указує на об'єкт Python.

Посилання Excel

Код Python може посилатися на значення в Excel за допомогою спеціальної функції Python xl().  

Функція xl() підтримує посилання на такі об'єкти Excel:

  • Діапазони
  • Імена
  • Таблиці
  • Зображення
  • Power QueryPower Query connections

Функція xl() підтримує необов'язковий аргумент headers. Аргумент заголовків визначає, чи має перший рядок заголовки. Наприклад, xl("A1:Z10", headers=True) указує, що клітинки A1:Z1 – це заголовки. 

Примітки

  • Функцію PY можна переглядати за допомогою функції FORMULATEXT , а також записувати й читати надбудови.
  • Функція PY не відображається в рядку формул, оскільки вона відображається в редакторі Python. 
  • Функцію PY не можна використовувати з іншими функціями Excel. У разі використання формул з іншими функціями ввести неможливо.
  • Обидва аргументи python_code та return_type мають бути статичними.

Приклади

У прикладі 1 оператор Python plus використовується для створення "Hello WorldHello World" з 3 фрагментів тексту. 

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

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

Приклад 2 використовує xl() функцію для отримання даних із таблиці1 і повертає результат як об'єкт Python. 

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