Applies ToExcel para Microsoft 365

Use 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. 

  • 0 indica o valor do Excel.

  • 1 indica o objeto Python.

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) 

Precisa de mais ajuda?

Quer mais opções

Explore os benefícios da assinatura, procure cursos de treinamento, saiba como proteger seu dispositivo e muito mais.

As comunidades ajudam você a fazer e responder perguntas, fazer comentários e ouvir especialistas com conhecimento avançado.