Clase para escribir objetos DataFrame en hojas de Excel.
El valor predeterminado es usar xlwt para xls, openpyxl para xlsx, odf para ods. Consulte DataFrame.to_excel para conocer el uso típico.
El escritor debe utilizarse como administrador de contexto. De lo contrario, llame cerrar() para guardar y cerrar cualquier identificador de archivo abierto.
- Parámetros
-
- sendero : str o escribiendo.BinaryIO
-
Ruta al archivo xls o xlsx o ods.
- motor : cadena (opcional)
-
Motor a utilizar para escribir. Si ninguno, el valor predeterminado es io.excel..writer
. NOTA: solo se puede pasar como un argumento de palabra clave.
En desuso desde la versión 1.2.0: como el xlwt paquete ya no se mantiene, el xlwt
El motor se eliminará en una versión futura de pandas.
- formato de fecha : str, predeterminado Ninguno
-
Formato string para fechas escritas en archivos de Excel (por ejemplo, ‘YYYY-MM-DD’).
- formato de fecha y hora : str, predeterminado Ninguno
-
Formato string para objetos de fecha y hora escritos en archivos de Excel. (por ejemplo, ‘AAAA-MM-DD HH:MM:SS’).
- modo : ‘w’, ‘a’, por defecto ‘w’
-
Modo de archivo a usar (escribir o agregar). Append no funciona con direcciones URL de fsspec.
Nuevo en la versión 0.24.0.
- opciones_de_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 “s3://”, “gcs://”.
Nuevo en la versión 1.2.0.
notas
Ninguno de los métodos y propiedades se consideran públicos.
Para la compatibilidad con los escritores CSV, ExcelWriter serializa listas y dicta en cadenas antes de escribir.
Ejemplos
Uso predeterminado:
>>>with ExcelWriter('path_to_file.xlsx')as writer:... df.to_excel(writer)
Para escribir en hojas separadas en un solo archivo:
>>>with ExcelWriter('path_to_file.xlsx')as writer:... df1.to_excel(writer, sheet_name='Sheet1')... df2.to_excel(writer, sheet_name='Sheet2')
Puede configurar el formato de fecha o el formato de fecha y hora:
>>>with ExcelWriter('path_to_file.xlsx',... date_format='YYYY-MM-DD',... datetime_format='YYYY-MM-DD HH:MM:SS')as writer:... df.to_excel(writer)
También puede agregar a un archivo de Excel existente:
>>>with ExcelWriter('path_to_file.xlsx', mode='a')as writer:... df.to_excel(writer, sheet_name='Sheet3')
Puede almacenar archivos de Excel en RAM:
>>>import io
>>>buffer= io.BytesIO()>>>with pd.ExcelWriter(buffer)as writer:... df.to_excel(writer)
Puede empaquetar el archivo de Excel en un archivo zip:
>>>import zipfile
>>>with zipfile.ZipFile('path_to_file.zip','w')as zf:...with zf.open('filename.xlsx','w')asbuffer:...with pd.ExcelWriter(buffer)as writer:... df.to_excel(writer)
Atributos
Métodos