Funzione PY

Si applica a
Excel per Microsoft 365 Excel per Microsoft 365 per Mac

Dopo aver immesso =PY in una cella e aver selezionato la funzione PY dal menu Completamento automatico, l'esperienza di modifica della cella si trasforma in un editor Python. Per altre informazioni, vedere Introduzione a Python in Excel e Introduzione a Python in Excel

Importante

La funzione PY non può essere immessa o visualizzata direttamente dalla barra della formula di Excel, ma l'editor Python la genererà e la inserirà automaticamente nella cella. La sintassi della funzione PY viene usata principalmente dai componenti aggiuntivi per inserire o leggere direttamente formule Python. Può essere visualizzata anche quando si usa la funzione TESTO.FORMULA in una cella contenente una formula Python. 

Sintassi

La funzione PY esegue codice Python in un runtime Microsoft Cloud sicuro. Il risultato viene restituito come oggetto Python o come valore di Excel. 

=PY(python_code,return_type) 

Argomento Descrizione
python_code
(obbligatorio)
Il codice Python da eseguire in un runtime Microsoft Cloud sicuro. Deve essere testo statico.
return_type
(obbligatorio)
Specificare il tipo restituito desiderato. Deve essere un numero statico, 0 o 1.
  • 0 indica un valore di Excel.
  • 1 indica l'oggetto Python.

Riferimenti a Excel

Il codice Python può fare riferimento ai valori in Excel usando la funzione Python personalizzata xl().  

La xl() funzione supporta il riferimento agli oggetti di Excel seguenti.

  • Intervalli
  • Nomi
  • Tabelle
  • Immagini
  • Connessioni a Power Query

La xl() funzione supporta un argomento di intestazione facoltativo. L'argomento headers specifica se la prima riga contiene intestazioni. Ad esempio, xl("A1:Z10", headers=True) indica che le celle A1:Z1 sono intestazioni. 

Osservazioni

  • La funzione PY può essere visualizzata da TESTO.FORMULA e scritta e letta dai componenti aggiuntivi.
  • La funzione PY non è visibile nella barra della formula così come viene visualizzata usando l'editor Python. 
  • La funzione PY non può essere usata con altre funzioni di Excel. Se utilizzata con altre funzioni, non è possibile immettere una formula.
  • Entrambi gli argomenti python_code e return_type devono essere statici.

Esempi

L'esempio 1 utilizza l'operatore Python plus per generare "Hello World" da 3 frammenti di testo. 

=PY('Hello' + ' ' + 'World',0) 

 ———————————————————————————

L'esempio 2 usa la xl() funzione per ottenere i dati da Table1 e restituisce il risultato come oggetto Python. 

=PY("xl(""Table1[#All]"", headers=True)",1)