pandas.Series.to_excel

Series.to_excel(self, 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) [source]

Запись объекта в лист Excel.

Чтобы записать один объект в файл Excel .xlsx, достаточно указать имя целевого файла. Чтобы записать в несколько листов, необходимо создать объект ExcelWriter с именем целевого файла и указать лист в файле, в который необходимо записать.

В несколько листов можно записать, указав уникальные sheet_name. После записи всех данных в файл необходимо сохранить изменения. Обратите внимание, что создание объекта ExcelWriter с именем файла, который уже существует, приведёт к стиранию содержимого существующего файла.

Параметры:

excel_writer : str or ExcelWriter object Путь к файлу или существующий объект ExcelWriter. sheet_name : str, default ‘Sheet1’ Имя листа, который будет содержать DataFrame. na_rep : str, default ‘’ Представление пропущенных данных. float_format : str, optional Строковый формат для чисел с плавающей точкой. Например, float_format="%.2f" отформатирует 0.1234 до 0.12. columns : sequence or list of str, optional Столбцы для записи. header : bool or list of str, default True Записать имена столбцов. Если задан список строк, предполагается, что это псевдонимы для имён столбцов. index : bool, default True Записать имена строк (индекс). index_label : str or sequence, optional Имя метки столбца для столбца(ов) индекса, если нужно. Если не указано, а header и index равны True, то используются имена индекса. Должен быть задан последовательность, если DataFrame использует MultiIndex. startrow : int, default 0 Номер строки ячейки в верхнем левом углу для выгрузки DataFrame. startcol : int, default 0 Номер столбца ячейки в верхнем левом углу для выгрузки DataFrame. engine : str, optional Используемый движок записи, ‘openpyxl’ или ‘xlsxwriter’. Также можно задать это через параметры io.excel.xlsx.writer, io.excel.xls.writer, и io.excel.xlsm.writer. merge_cells : bool, default True Записывать MultiIndex и иерархические строки как объединённые ячейки. encoding : str, optional Кодировка результирующего файла Excel. Необходимо только для xlwt, другие движки поддерживают unicode напрямую. inf_rep : str, default ‘inf’ Представление бесконечности (в Excel нет родного представления бесконечности). verbose : bool, default True Выводить больше информации в журналы ошибок. freeze_panes : tuple of int (length 2), optional Указывает самую нижнюю строку и самый правый столбец, которые нужно заморозить (основано на единице). Введено в версии 0.20.0.

См. также

to_csv

Запись DataFrame в файл с разделителем запятых (csv).

ExcelWriter

Класс для записи объектов DataFrame в листы Excel.

read_excel

Чтение файла Excel в pandas DataFrame.

read_csv

Чтение файла с разделителем запятых (csv) в DataFrame.

Примечания

Для совместимости с 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")  # doctest: +SKIP

Чтобы указать имя листа:

>>> df1.to_excel("output.xlsx",
...              sheet_name='Sheet_name_1')  # doctest: +SKIP

Если нужно записать в несколько листов в книге, необходимо указать объект ExcelWriter:

>>> df2 = df1.copy()
>>> with pd.ExcelWriter('output.xlsx') as writer:  # doctest: +SKIP
...     df1.to_excel(writer, sheet_name='Sheet_name_1')
...     df2.to_excel(writer, sheet_name='Sheet_name_2')

Чтобы задать библиотеку для записи файла Excel, можно передать параметр engine (по умолчанию движок выбирается автоматически в зависимости от расширения файла):

>>> df1.to_excel('output1.xlsx', engine='xlsxwriter')  # doctest: +SKIP