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.
Importante
A função PY não pode ser inserida diretamente ou vista na barra de fórmulas do Excel, em vez disso, o editor do Python irá gerá-la e inseri-la na célula para você. A sintaxe da função PY é usada principalmente por suplementos para inserir ou ler diretamente fórmulas do Python. Ele também pode ser visto ao usar a função FORMULATEXT em uma célula que contém uma fórmula python.
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 xl() função dá suporte a referenciar os seguintes objetos do Excel.
- Intervalos
- Nomes
- Tabelas
- Imagens
- Power Query conexões
A função dá suporte a xl() um argumento de cabeçalhos opcionais. 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 pode ser vista por FORMULATEXT e escrita e lida por suplementos.
- A função PY não está visível na barra de fórmulas , pois é exibida usando o editor do Python.
- 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.
- 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 xl() função para obter os dados do Table1 e retorna o resultado como um objeto Python.
=PY("xl(""Table1[#All]"", headers=True)",1)