Depois de inserir =PY em uma célula e selecionar a função PY no menu de Preenchimento Automático, a experiência de edição de célula se transforma em um editor 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 ou vista diretamente na barra de fórmulas do Excel, em vez disso, o editor 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 fórmulas Python diretamente. Também pode ser visto ao usar a função FORMULATEXT em uma célula contendo uma fórmula Python.
Sintaxe
A função PY executa código Python em um Microsoft Cloud runtime seguro. 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 para ser executado em um Microsoft Cloud runtime seguro. 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 fazer referência a valores no Excel usando a função Python personalizada xl().
A xl() função dá suporte à referência aos seguintes objetos do Excel.
- Intervalos
- Nomes
- Tabelas
- Imagens
- Conexões do Power Query
A xl() função dá suporte a um argumento de cabeçalhos opcional. O argumento headers 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 gravada e lida por suplementos.
- A função PY não é visível na barra de fórmulas como é exibida usando o editor Python.
- A função PY não pode ser usada com nenhuma outra função do Excel. Se usado 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 mais 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 da Tabela1 e retorna o resultado como um objeto Python.
=PY("xl(""Table1[#All]"", headers=True)",1)