Depois de introduzir =PY numa célula e selecionar a função PY no menu de Conclusão Automática, a experiência de edição de células transforma-se num editor Python. Para saber mais, consulte Introdução ao Python no Excel e Introdução ao Python no Excel.
Importante
A função PY não pode ser introduzida diretamente ou vista a partir da barra de fórmulas do Excel, em vez disso, o editor Python irá gerá-la e inseri-la na célula para si. A sintaxe da função PY é utilizada principalmente por suplementos para inserir ou ler diretamente fórmulas Python. Também pode ser visto ao usar a função FÓRMULA.TEXTO numa célula que contém uma fórmula Python.
Sintaxe
A função PY executa o código Python num tempo de execução seguro do Microsoft Cloud. O resultado é devolvido 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 num tempo de execução seguro do Microsoft Cloud. Tem de ser texto estático. |
|
return_type (obrigatório) |
Especifique o tipo de retorno desejado. Tem de ser um número estático 0 ou 1.
|
Referências do Excel
O código Python pode referenciar valores no Excel através da função Python personalizada xl().
A xl() função suporta a referência dos seguintes objetos do Excel.
- Intervalos
- Nomes
- Tabelas
- Imagens
- Power Query conexões
A xl() função suporta 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 pode ser vista por FÓRMULATEXTO e escrita e lida por suplementos.
- A função PY não é visível na barra de fórmulas, pois é exibida usando o editor Python.
- A função PY não pode ser utilizada com outras funções do Excel. Se for utilizada com outras funções, não será possível introduzir uma fórmula.
- Os argumentos python_code e return_type têm de ser estáticos.
Exemplos
O Exemplo 1 utiliza o operador Python plus para gerar "Hello World" a partir de 3 fragmentos de texto.
=PY('Hello' + ' ' + 'World',0)
———————————————————————————
O Exemplo 2 utiliza a xl() função para obter os dados da Tabela1 e devolve o resultado como um objeto Python.
=PY("xl(""Table1[#All]"", headers=True)",1)