Función PY

Se aplica a
Excel para Microsoft 365 Excel para Microsoft 365 para Mac

Después de escribir =PY en una celda y seleccionar la función PY en el menú Autocompletar, la experiencia de edición de celdas se transforma en un editor de Python. Para obtener más información, consulte Introducción a Python en Excel e Introducción a Python en Excel. 

Importante

La función PY no se puede escribir ni ver directamente desde la barra de fórmulas de Excel, sino que el editor de Python la generará e insertará en la celda por usted. La sintaxis de la función PY la usan principalmente los complementos para insertar o leer directamente fórmulas de Python. También se puede ver al usar la función FORMULATEXT en una celda que contiene una fórmula de Python. 

Sintaxis

La función PY ejecuta código de Python en un entorno de ejecución seguro de Microsoft Cloud. El resultado se devuelve como un objeto de Python o un valor de Excel. 

=PY(python_code,return_type) 

argumento Descripción
python_code
(obligatorio)
El código de Python para ejecutarse en un entorno de ejecución seguro de Microsoft Cloud. Debe ser texto estático.
return_type
(obligatorio)
Especifique el tipo de valor devuelto deseado. Debe ser un número estático 0 o 1.
  • 0 indica un valor de Excel.
  • 1 indica el objeto de Python.

Referencias de Excel

El código de Python puede hacer referencia a valores en Excel mediante la función de Python personalizada xl().  

La xl() función admite hacer referencia a los siguientes objetos de Excel.

  • Intervalos
  • Nombres
  • Tablas
  • Imágenes
  • Conexiones de Power Query

La xl() función admite un argumento de encabezados opcional. El argumento de encabezados especifica si la primera fila tiene encabezados. Por ejemplo, xl("A1:Z10", headers=True) indica que las celdas A1:Z1 son encabezados. 

Observaciones

  • La función PY puede ser vista por FORMULATEXT y escrita y leída por complementos.
  • La función PY no está visible en la barra de fórmulas , ya que se muestra con el editor de Python. 
  • La función PY no se puede usar con ninguna otra función de Excel. Si se usa con otras funciones, no se puede introducir una fórmula.
  • Tanto el argumento python_code como el return_type deben ser estáticos.

Ejemplos

El ejemplo 1 usa el operador más de Python para generar "Hola mundo" a partir de 3 fragmentos de texto. 

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

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

En el ejemplo 2 se usa la xl() función para obtener los datos de Tabla1 y se devuelve el resultado como un objeto de Python. 

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