Démarrage avec Python dans Excel

S’applique à
Excel pour Microsoft 365 Excel pour Microsoft 365 pour Mac

Pour plus d’informations sur la disponibilité, consultez Disponibilité de Python dans Excel. Si vous rencontrez des problèmes avec Python dans Excel, signalez-les en sélectionnant Commentaires d’aide> dans Excel.

Vous débutez avec Python dans Excel ? Commencez par une introduction à Python dans Excel.

Commencer à utiliser Python

Pour commencer à utiliser Python dans Excel, sélectionnez une cellule, puis sous l’onglet Formules , sélectionnez Insérer Python. Cela indique à Excel que vous souhaitez écrire une formule Python dans la cellule sélectionnée.

Accédez à Formules, puis sélectionnez Insérer un fichier Python.

Vous pouvez également utiliser la fonction =PY dans une cellule pour activer Python. Après avoir entré =PY dans la cellule, choisissez PY dans le menu de saisie semi-automatique de la fonction avec les touches Flèche vers le bas et Tab, ou ajoutez une parenthèse ouvrante à la fonction : =PY(. Maintenant, vous pouvez entrer du code Python directement dans la cellule. La capture d’écran suivante montre le menu de saisie semi-automatique avec la fonction PY sélectionnée.

Entrez =PY dans une cellule pour activer Python.

Une fois Python activé dans une cellule, cette cellule affiche une icône PY . La barre de formule affiche la même icône PY lorsque la cellule Python est sélectionnée. Pour obtenir un exemple, consultez la capture d’écran suivante.

Un classeur Excel avec Python dans Excel activé dans une cellule, affichant l’icône PY verte dans la cellule.

Combiner Python avec des cellules et des plages Excel

Pour référencer des objets Excel dans une cellule Python, assurez-vous que la cellule Python est en mode Édition, puis sélectionnez la cellule ou la plage que vous souhaitez inclure dans la formule Python. Cela remplit automatiquement la cellule Python avec l’adresse de la cellule ou de la plage que vous avez sélectionnée.

Conseil

Utilisez le raccourci clavier F2 pour basculer entre le mode Entrée et le mode Édition dans les cellules Python. Le basculement vers le mode d’édition vous permet de modifier la formule Python, et le basculement vers le mode Entrée vous permet de sélectionner des cellules ou plages supplémentaires avec votre clavier. Pour en savoir plus sur les raccourcis clavier, consultez Raccourcis clavier Python dans Excel.

Python dans Excel utilise la fonction xl() Python personnalisée pour assurer l’interface entre Excel et Python. La xl() fonction accepte des objets Excel tels que des plages, des tableaux, des requêtes et des noms.

Vous pouvez également taper directement des références dans une cellule Python avec la xl() fonction. Par exemple, pour référencer la cellule A1 , utilisez xl("A1") et pour la plage B1 :C4 , utilisez xl("B1:C4"). Pour un tableau avec des en-têtes nommés MyTable, utilisez xl("MyTable[#All]", headers=True). Le spécificateur [#All] garantit que l’ensemble du tableau est analysé dans la formule Python et headers=True que les en-têtes de tableau sont traités correctement. Pour en savoir plus sur les spécificateurs tels que [#All], voir Utilisation de références structurées avec des tableaux Excel.

L’image suivante montre un calcul Python dans Excel ajoutant les valeurs des cellules A1 et B1, avec le résultat Python retourné dans la cellule C1.

Utilisez la fonction Python personnalisée xl() pour assurer l’interface entre Excel et Python.

Formula bar

Utilisez la barre de formule pour un comportement d’édition de type code, comme l’utilisation de la touche Entrée pour créer de nouvelles lignes. Développez la barre de formule à l’aide de l’icône de flèche vers le bas pour afficher plusieurs lignes de code à la fois. Vous pouvez également utiliser le raccourci clavier Ctrl+Maj+U pour développer la barre de formule. Les captures d’écran suivantes montrent une barre de formule avant et après son développement pour afficher plusieurs lignes de code Python.

Avant de développer la barre de formule :
...

Après avoir développé la barre de formule :

Développez la barre de formule pour afficher d’autres lignes de code.

Conseil

Pour un espace d’édition de code encore plus grand et des fonctionnalités telles que la colorisation du texte et IntelliSense, utilisez l’éditeur de code Python dans Excel.

Types de sortie

Utilisez le menu de sortie Python dans la barre de formule pour contrôler la façon dont les calculs Python sont retournés. Renvoyer les calculs en tant qu’objets Python ou convertir les calculs en valeurs Excel et les générer directement dans une cellule. La capture d’écran suivante montre la formule Python retournée sous la forme d’une valeur Excel.

Conseil

Vous pouvez également utiliser le menu contextuel pour modifier le type de sortie Python. Ouvrez le menu contextuel et accédez à Sortie Python, puis sélectionnez le type de sortie souhaité.

Utilisez le menu de sortie Python pour basculer entre les types de sortie.

La capture d’écran suivante montre la même formule Python que la capture d’écran précédente, maintenant retournée en tant qu’objet Python. Lorsqu’une formule est renvoyée en tant qu’objet Python, la cellule affiche une icône de carte.

Remarque

Les résultats de formule renvoyés aux valeurs Excel sont convertis dans leur équivalent Excel le plus proche. Si vous envisagez de réutiliser le résultat dans un futur calcul Python, il est recommandé de retourner le résultat en tant qu’objet Python. Le renvoi d’un résultat sous forme de valeurs Excel vous permet d’exécuter des analyses Excel sur la valeur, telles que des graphiques, des formules et une mise en forme conditionnelle Excel.

Lorsque les données sont renvoyées en tant qu’objet Python, la cellule affiche une icône de carte Python.

Un objet Python contient des informations supplémentaires dans la cellule. Pour afficher les informations supplémentaires, ouvrez le carte en sélectionnant l’icône carte. Les informations affichées sur la carte sont un aperçu de l’objet, ce qui est utile lors du traitement d’objets volumineux.

Python dans Excel peut retourner de nombreux types de données sous forme d’objets Python. Un type de données Python dans Excel utile est un objet DataFrame. Pour en savoir plus sur les DataFrames Python, consultez Python dans les DataFrames Excel.

Importer des données externes

Toutes les données que vous traitez avec Python dans Excel doivent provenir de votre feuille de calcul ou de Power Query. Pour importer des données externes, utilisez la fonctionnalité Obtenir & transformer dans Excel pour accéder à Power Query. Pour plus d’informations, voir Utiliser Power Query pour importer des données pour Python dans Excel.

Important

Pour protéger votre sécurité, les fonctions de données externes courantes dans Python, telles que pandas.read_csv et pandas.read_excel, ne sont pas compatibles avec Python dans Excel. Pour plus d’informations, consultez Sécurité des données et Python dans Excel.

Ordre de calcul

Les instructions Python traditionnelles calculent de haut en bas. Dans une cellule Python dans Excel, les instructions Python font la même chose : elles calculent de haut en bas. Mais dans une feuille de calcul Python dans Excel, les cellules Python calculent dans l’ordre des lignes principales. Les calculs de cellule s’exécutent sur une ligne (de la colonne A à la colonne XFD), puis sur chaque ligne suivante de la feuille de calcul.

Les instructions Python sont ordonnées, de sorte que chaque instruction Python a une dépendance implicite sur l’instruction Python qui la précède immédiatement dans l’ordre de calcul.

L’ordre de calcul est important lors de la définition et du référencement des variables dans une feuille de calcul, car vous devez définir les variables avant de pouvoir les référencer.

Important

L’ordre de calcul row-main s’applique également à toutes les feuilles de calcul d’un classeur et est basé sur l’ordre des feuilles de calcul dans le classeur. Si vous utilisez plusieurs feuilles de calcul pour analyser des données avec Python dans Excel, veillez à inclure les données et les variables stockant les données dans les cellules et feuilles de calcul précédant les cellules et feuilles de calcul qui analysent ces données.

Recalcul

Lorsqu’une valeur dépendante d’une cellule Python change, toutes les formules Python sont recalculées séquentiellement. Pour suspendre les recalculs Python et améliorer les performances, utilisez le mode Calcul partiel ou Calcul manuel . Ces modes vous permettent de déclencher un calcul lorsque vous êtes prêt. Pour modifier ce paramètre, accédez au ruban et sélectionnez Formules, puis ouvrez Options de calcul. Sélectionnez ensuite le mode de calcul souhaité. Les modes Calcul partiel et Calcul manuel suspendent le recalcul automatique pour Python et les tables de données.

La désactivation du recalcul automatique dans un classeur pendant le développement de Python peut améliorer les performances et les vitesses de calcul des cellules Python individuelles. Toutefois, vous devez recalculer manuellement le classeur pour garantir la précision dans chaque cellule Python. Il existe trois façons de recalculer manuellement un classeur en mode calcul partiel ou calcul manuel .

  1. Utilisez le raccourci clavier F9.
  2. Accédez à Formules>Calculer maintenant dans le ruban.
  3. Atteindre une cellule avec une valeur obsolète, affichée avec une mise en forme barrée, puis sélectionnez le symbole d’erreur en regard de cette cellule. Sélectionnez ensuite Calculer maintenant dans le menu.

Erreurs

Python dans les calculs Excel peut retourner des erreurs telles que #PYTHON !, #BUSY !, et #CONNECT ! aux cellules Python. Pour en savoir plus, consultez Résoudre les erreurs Python dans Excel.