Escribe el objeto en una hoja de Excel.
Para escribir un solo objeto en un archivo .xlsx de Excel, solo es necesario especificar un nombre de archivo de destino. Para escribir en varias hojas es necesario crear un ExcelWriter objeto con un nombre de archivo de destino y especifique una hoja en el archivo para escribir.
Se pueden escribir varias hojas especificando un único sheet_name. Con todos los datos escritos en el archivo, es necesario guardar los cambios. Tenga en cuenta que la creación de un ExcelWriter objeto con un nombre de archivo que ya existe dará lugar a que se borre el contenido del archivo existente.
- Parámetros
-
-
excel_writer : objeto tipo ruta, archivo o ExcelWriter
-
Ruta de archivo o ExcelWriter existente.
-
sheet_name : str, predeterminado ‘Hoja1’
-
Nombre de la hoja que contendrá DataFrame.
-
na_rep : str, predeterminado ”
-
Falta representación de datos.
-
float_format : str, opcional
-
Formato de cadena para números de coma flotante. Por ejemplo float_format="%.2f"
formateará 0.1234 a 0.12.
-
columnas : secuencia o lista de str, opcional
-
Columnas para escribir.
-
encabezamiento : bool o lista de str, por defecto True
-
Escriba los nombres de las columnas. Si se proporciona una lista de cadenas, se asume que son alias para los nombres de las columnas.
-
índice : bool, por defecto True
-
Escriba los nombres de las filas (índice).
-
index_label : str o secuencia, opcional
-
Etiqueta de columna para la (s) columna (s) de índice si lo desea. Si no se especifica, y encabezamiento y índice son True, entonces se utilizan los nombres de índice. Se debe dar una secuencia si el DataFrame usa MultiIndex.
-
startrow : int, predeterminado 0
-
Fila de celda superior izquierda para volcar el marco de datos.
-
startcol : int, predeterminado 0
-
Columna de celda superior izquierda para volcar el marco de datos.
-
motor : str, opcional
-
Escriba el motor para usar, ‘openpyxl’ o ‘xlsxwriter’. También puede configurar esto a través de las opciones io.excel.xlsx.writer
, io.excel.xls.writer
, y io.excel.xlsm.writer
.
En desuso desde la versión 1.2.0: Como el xlwt el paquete ya no se mantiene, el xlwt
El motor se eliminará en una versión futura de pandas.
-
combinar células : bool, por defecto True
-
Escriba filas jerárquicas y de índice múltiple como celdas combinadas.
-
codificacion : str, opcional
-
Codificación del archivo de Excel resultante. Solo es necesario para xlwt, otros escritores admiten unicode de forma nativa.
-
inf_rep : str, predeterminado ‘inf’
-
Representación del infinito (no existe una representación nativa del infinito en Excel).
-
verboso : bool, por defecto True
-
Muestra más información en los registros de errores.
-
freeze_panes : tupla de int (longitud 2), opcional
-
Especifica la fila inferior y la columna más a la derecha basadas en uno que se congelarán.
-
opciones_almacenamiento : dict, opcional
-
Opciones adicionales que tienen sentido para una conexión de almacenamiento en particular, por ejemplo, host, puerto, nombre de usuario, contraseña, etc., si usa una URL que será analizada por fsspec
, por ejemplo, comenzando con “s3: //”, “gcs: //”. Se generará un error si se proporciona este argumento con una URL que no sea fsspec. Consulte los documentos de implementación de almacenamiento de backend y fsspec para conocer el conjunto de claves y valores permitidos.
Nuevo en la versión 1.2.0.
Ver también
to_csv
-
Escriba DataFrame en un archivo de valores separados por comas (csv).
ExcelWriter
-
Clase para escribir objetos DataFrame en hojas de Excel.
read_excel
-
Leer un archivo de Excel en un DataFrame de pandas.
read_csv
-
Lea un archivo de valores separados por comas (csv) en DataFrame.
Notas
Por compatibilidad con to_csv()
, to_excel serializa listas y dicta a cadenas antes de escribir.
Una vez que se ha guardado un libro de trabajo, no es posible escribir más datos sin volver a escribir el libro de trabajo completo.
Ejemplos de
Cree, escriba y guarde un libro de trabajo:
>>> df1 = pd.DataFrame([['a', 'b'], ['c', 'd']],
... index=['row 1', 'row 2'],
... columns=['col 1', 'col 2'])
>>> df1.to_excel("output.xlsx")
Para especificar el nombre de la hoja:
>>> df1.to_excel("output.xlsx",
... sheet_name='Sheet_name_1')
Si desea escribir en más de una hoja en el libro de trabajo, es necesario especificar un objeto ExcelWriter:
>>> df2 = df1.copy()
>>> with pd.ExcelWriter('output.xlsx') as writer:
... df1.to_excel(writer, sheet_name='Sheet_name_1')
... df2.to_excel(writer, sheet_name='Sheet_name_2')
ExcelWriter también se puede utilizar para adjuntar a un archivo de Excel existente:
>>> with pd.ExcelWriter('output.xlsx',
... mode='a') as writer:
... df.to_excel(writer, sheet_name='Sheet_name_3')
Para configurar la biblioteca que se utiliza para escribir el archivo de Excel, puede pasar la motor palabra clave (el motor predeterminado se elige automáticamente según la extensión del archivo):
>>> df1.to_excel('output1.xlsx', engine='xlsxwriter')