pandas.io.formats.style.Styler.to_excel

Styler.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)[source]

Запись стилизованной таблицы в электронную таблицу Excel.

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

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

Параметры

excel_writer:путь, поток или объект ExcelWriter

Путь к файлу или существующий объект ExcelWriter.

sheet_name:строка, по умолчанию ‘Sheet1’

Имя листа, который будет содержать DataFrame.

na_rep:строка, по умолчанию ‘’

Представление пропущенных данных.

float_format:строка, необязательно

Строка формата для чисел с плавающей запятой. Например float_format="%.2f" отформатирует 0.1234 до 0.12.

columns:последовательность или список строк, необязательно

Столбцы для записи.

header:булево значение или список строк, по умолчанию True

Записать заголовки столбцов. Если задан список строк, предполагается, что это псевдонимы названий столбцов.

index:булево значение, по умолчанию True

Записать имена строк (индекс).

index_label:строка или последовательность, необязательно

Имя столбца для столбца(ов) индекса, если необходимо. Если не указано, и header и index равны True, то используются имена индекса. Для MultiIndex должна быть задана последовательность.

startrow:целое число, по умолчанию 0

Номер строки верхнего левого ячейки для вывода DataFrame.

startcol:целое число, по умолчанию 0

Номер столбца верхнего левого ячейки для вывода DataFrame.

engine:строка, необязательно

Двигатель записи, ‘openpyxl’ или ‘xlsxwriter’. Также можно задать это через опции io.excel.xlsx.writer, io.excel.xls.writer, и io.excel.xlsm.writer.

Устарело начиная с версии 1.2.0: Так как пакет xlwt больше не поддерживается, движок xlwt будет удален в будущей версии pandas.

merge_cells:булево значение, по умолчанию True

Записать MultiIndex и Иерархические Строки в виде объединённых ячеек.

encoding:строка, необязательно

Кодировка создаваемого файла Excel. Необходимо только для xlwt, другие писатели поддерживают Unicode напрямую.

Устарело начиная с версии 1.5.0: Это ключевое слово не использовалось.

inf_rep:строка, по умолчанию ‘inf’

Представление бесконечности (в Excel нет родного представления для бесконечности).

verbose:булево значение, по умолчанию True

Выводить больше информации в журнале ошибок.

Устарело начиная с версии 1.5.0: Это ключевое слово не использовалось.

freeze_panes:кортеж из 2 целых чисел, необязательно

Указывает нижнюю строку и правый столбец, которые должны быть заморожены (с нумерацией с 1).

storage_options:словарь, необязательно

Дополнительные параметры, которые имеют смысл для определенного соединения хранения, например, хост, порт, имя пользователя, пароль и т. д. Для HTTP(S) URL ключи-значения передаются в urllib.request.Request в качестве параметров заголовка. Для других URL (например, начинающихся с “s3://”, и “gcs://”) ключи-значения передаются в fsspec.open. Подробнее см. fsspec и urllib, а примеры параметров хранения см. здесь.

Новое в версии 1.5.0.

См. также

to_csv

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

ExcelWriter

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

read_excel

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

read_csv

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

io.formats.style.Styler.to_excel

Добавление стилей в лист Excel.

Примечания

Для совместимости с 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')