Applies ToExcel para Microsoft 365

Utilize 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

(obrigatório)

O código Python a executar num runtime seguro do Microsoft Cloud. Tem de ser texto estático.

return_type

(obrigatório)

Especifique o tipo de retorno pretendido. Tem de 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 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) 

Precisa de mais ajuda?

Quer mais opções?

Explore os benefícios da subscrição, navegue em cursos de formação, saiba como proteger o seu dispositivo e muito mais.

As comunidades ajudam-no a colocar e a responder perguntas, a dar feedback e a ouvir especialistas com conhecimentos abrangentes.