Python pandas.DataFrame.to_excel用法及代码示例

用法: DataFrame.to_excel(excel_writer, sheet_name='Sheet1', na_rep='', float_format=None, columns=None, header=True, index=True, index_label=None, startrow=0, startcol=0, engine=None, merge_cells=True, encoding=None, inf_rep='inf', verbose=True, freeze_panes=None, storage_options=None)

将对象写入 Excel 工作表。

要将单个对象写入 Excel .xlsx 文件，只需指定目标文件名。要写入多个工作表，需要使用目标文件名创建ExcelWriter 对象，并在文件中指定要写入的工作表。

通过指定唯一的 sheet_name 可以写入多个工作表。将所有数据写入文件后，有必要保存更改。请注意，使用已存在的文件名创建ExcelWriter 对象将导致现有文件的内容被擦除。

参数：

excel_writer：path-like、file-like 或 ExcelWriter 对象

文件路径或现有 ExcelWriter。

sheet_name：str，默认为“Sheet1”

将包含 DataFrame 的工作表的名称。

na_rep：str，默认“”

缺少数据表示。

float_format：str，可选

浮点数的格式字符串。例如 float_format="%.2f" 会将 0.1234 格式化为 0.12。

columns：str 的序列或列表，可选

要写的列。

header：bool 或 str 列表，默认 True

写出列名。如果给出字符串列表，则假定它是列名的别名。

index：布尔值，默认为真

写行名(索引)。

index_label：str 或序列，可选

如果需要，索引列的列标签。如果未指定，并且 header 和 index 为 True，则使用索引名称。如果 DataFrame 使用 MultiIndex，则应给出一个序列。

startrow：整数，默认 0

左上角单元格行转储数据帧。

startcol：整数，默认 0

左上角单元格列转储 DataFrame 。

engine：str，可选

编写要使用的引擎，‘openpyxl’ or ‘xlsxwriter’。您也可以通过选项 io.excel.xlsx.writer 、 io.excel.xls.writer 和 io.excel.xlsm.writer 进行设置。

merge_cells：布尔值，默认为真

将 MultiIndex 和 Hierarchical Rows 写入合并单元格。

encoding：str，可选

生成的 excel 文件的编码。只有 xlwt 需要，其他编写器原生支持 unicode。

inf_rep：str，默认 ‘inf’

无穷大的表示(Excel 中没有无穷大的本机表示)。

verbose：布尔值，默认为真

在错误日志中显示更多信息。

freeze_panes：int 元组(长度为 2)，可选

指定要冻结的从 1 开始的最底行和最右列。

storage_options：字典，可选

对特定存储连接有意义的额外选项，例如主机、端口、用户名、密码等。对于 HTTP(S) URL，键值对作为标头选项转发到 urllib。对于其他 URL(例如以 “s3://” 和 “gcs://” 开头)，键值对被转发到 fsspec 。有关详细信息，请参阅fsspec 和urllib。

注意：

为了与 to_csv() 兼容，to_excel 在写入之前将列表和字典序列化为字符串。

保存工作簿后，如果不重写整个工作簿，就无法写入更多数据。

例子：

创建、写入和保存工作簿：

>>> df1 = pd.DataFrame([['a', 'b'], ['c', 'd']],
...                    index=['row 1', 'row 2'],
...                    columns=['col 1', 'col 2'])
>>> df1.to_excel("output.xlsx")

要指定工作表名称：

>>> df1.to_excel("output.xlsx",
...              sheet_name='Sheet_name_1')

如果您希望写入工作簿中的多个工作表，则需要指定一个 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 也可用于附加到现有的 Excel 文件：

>>> with pd.ExcelWriter('output.xlsx',
...                     mode='a') as writer: 
...     df.to_excel(writer, sheet_name='Sheet_name_3')

要设置用于编写 Excel 文件的库，您可以传递 engine 关键字(根据文件扩展名自动选择默认引擎)：

>>> df1.to_excel('output1.xlsx', engine='xlsxwriter')

相关用法

注：本文由纯净天空筛选整理自pandas.pydata.org大神的英文原创作品 pandas.DataFrame.to_excel。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。