Função PY
Applies To
Excel para Microsoft 365Utilize a função PY para aceder ao Python no Excel a partir da grelha do Excel do Microsoft 365.
Importante: Depois de introduzir =PY numa célula e selecionar a função PY no menu Conclusão Automática, a experiência de edição de células transforma-se num editor de Python. Para saber mais, consulte Introdução ao Python no Excel e Introdução ao Python no Excel.
Sintaxe
A função PY executa código Python num runtime 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 (necessário) |
O código Python a executar num runtime seguro do Microsoft Cloud. Tem de ser texto estático. |
return_type (necessário) |
Especifique o tipo de retorno pretendido. Tem de ser um número estático 0 ou 1.
|
Referências do Excel
O código Python pode referenciar valores no Excel com a função Python personalizada xl().
A funçãoxl()suporta a referência aos seguintes objetos do Excel.
-
Intervalos
-
Nomes
-
Tabelas
-
ligações de Power Query
A função xl() 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.
Observações
-
A função PY não pode ser utilizada com outras funções do Excel. Se for utilizada com outras funções, não é possível introduzir uma fórmula.
-
A função PY pode ser vista por FÓRMULA.TEXTO e escrita e lida por suplementos.
-
Os argumentos python_code e return_type têm de ser estáticos.
Exemplos
O exemplo 1 utiliza o operador de adição Python para gerar "Hello World" a partir de 3 fragmentos de texto.
=PY('Hello' + ' ' + 'World',0)
———————————————————————————
O exemplo 2 utiliza a função xl() para obter os dados da Tabela1 e devolve o resultado como um objeto Python.
=PY("xl(""Table1[#All]"", headers=True)",1)