Fonction PY
Applies To
Excel pour Microsoft 365Après avoir entré =PY dans une cellule et sélectionné la fonction PY dans le menu Saisie semi-automatique, l’expérience de modification de cellule se transforme en éditeur Python. Pour en savoir plus, consultez Présentation de Python dans Excel et Prise en main de Python dans Excel.
Important : La fonction PY ne peut pas être directement entrée ou vue à partir de la barre de formule d’Excel. Au lieu de cela, l’éditeur Python la génère et l’insère dans la cellule pour vous. La syntaxe de la fonction PY est principalement utilisée par les addins pour insérer ou lire des formules Python. Il peut également être vu lors de l’utilisation de la fonction FORMULETEXTE sur une cellule contenant une formule Python.
Syntaxe
La fonction PY exécute du code Python sur un runtime Microsoft Cloud sécurisé. Le résultat est retourné sous la forme d’un objet Python ou d’une valeur Excel. Syntaxe ci-dessous
=PY(python_code,return_type)
Argument |
Description |
python_code (obligatoire) |
Code Python à exécuter sur un runtime Microsoft Cloud sécurisé. Doit être du texte statique. |
return_type (obligatoire) |
Spécifiez le type de retour souhaité. Doit être un nombre statique 0 ou 1.
|
Références Excel
Le code Python peut référencer des valeurs dans Excel à l’aide de la fonction Python personnalisée xl().
La fonctionxl()prend en charge le référencement des objets Excel suivants.
-
Gammes
-
Noms
-
Tableaux
-
Power Query connexions
La fonction xl() prend en charge un argument d’en-tête facultatif. L’argument headers spécifie si la première ligne comporte des en-têtes. Par exemple, xl("A1:Z10", headers=True)indique que les cellules A1 :Z1 sont des en-têtes.
Remarques
-
La fonction PY peut être vue par FORMULETEXTE et écrite et lue par les compléments.
-
La fonction PY n’est pas visible dans la barre de formule telle qu’elle est affichée à l’aide de l’éditeur Python. est automatiquement défini.
-
La fonction PY ne peut pas être utilisée avec d’autres fonctions Excel. Si elle est utilisée avec d’autres fonctions, une formule ne peut pas être entrée.
-
Les arguments python_code et return_type doivent être statiques.
Exemples
L’exemple 1 utilise l’opérateur Python plus pour générer « Hello World » à partir de 3 fragments de texte.
=PY('Hello' + ' ' + 'World',0)
———————————————————————————
L’exemple 2 utilise la fonction xl() pour obtenir les données de Table1 et retourne le résultat sous la forme d’un objet Python.
=PY("xl(""Table1[#All]"", headers=True)",1)