Função PY
Applies To
Excel para Microsoft 365Use a função PY para acessar o Python no Excel na grade do Microsoft 365 Excel.
Importante: Depois de inserir =PY em uma célula e selecionar a função PY no menu AutoComplete, a experiência de edição de células se transforma em um editor do Python. Para saber mais, confira Introdução ao Python no Excel e Introdução ao Python no Excel.
Sintaxe
A função PY executa o código Python em um runtime seguro do Microsoft Cloud. O resultado é retornado como um objeto Python ou um valor do Excel.
=PY(python_code,return_type)
Argumento |
Descrição |
python_code (obrigatório) |
O código python a ser executado em um runtime seguro do Microsoft Cloud. Deve ser um texto estático. |
return_type (obrigatório) |
Especifique o tipo de retorno desejado. Deve ser um número estático 0 ou 1.
|
Referências do Excel
O código Python pode referenciar valores no Excel usando a função Python personalizada xl().
A funçãoxl()dá suporte a referenciar os seguintes objetos do Excel.
-
Intervalos
-
Nomes
-
Tabelas
-
Power Query conexões
A função xl() dá suporte a um argumento de cabeçalhos opcional. O argumento cabeçalhos especifica se a primeira linha tem cabeçalhos. Por exemplo, xl("A1:Z10", headers=True)indica que as células A1:Z1 são cabeçalhos.
Comentários
-
A função PY não pode ser usada com outras funções do Excel. Se usada com outras funções, uma fórmula não poderá ser inserida.
-
A função PY pode ser vista por FORMULATEXT e escrita e lida por suplementos.
-
Os argumentos python_code e return_type devem ser estáticos.
Exemplos
O exemplo 1 usa o operador Python plus para gerar "Olá, Mundo" de 3 fragmentos de texto.
=PY('Hello' + ' ' + 'World',0)
———————————————————————————
O exemplo 2 usa a função xl() para obter os dados do Table1 e retorna o resultado como um objeto Python.
=PY("xl(""Table1[#All]"", headers=True)",1)