Функція 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 Query

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

Примітки

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

Приклади

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

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

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

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

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