pandas.ExcelFile

classpandas.ExcelFile(path_or_buffer, engine=None, storage_options=None, engine_kwargs=None)[source]

Класс для разбора табличных листов Excel в объекты DataFrame.

Для получения дополнительной документации обратитесь к read_excel.

Параметры:

path_or_buffer:str, bytes, объект пути (pathlib.Path или py._path.local.LocalPath),

Объект файлоподобного объекта, рабочая книга xlrd или рабочая книга openpyxl. Если строка или объект пути, ожидается путь к файлу .xls, .xlsx, .xlsb, .xlsm, .odf, .ods или .odt.

engine:str, по умолчанию None

Если io не является буфером или путем, это необходимо для идентификации io. Поддерживаемые движки: xlrd, openpyxl, odf, pyxlsb, calamine Совместимость движков:

• xlrd поддерживает старые файлы Excel (.xls).

• openpyxl поддерживает более новые форматы файлов Excel.

• odf поддерживает форматы файлов OpenDocument (.odf, .ods, .odt).

• pyxlsb поддерживает двоичные файлы Excel.

• calamine поддерживает форматы файлов Excel (.xls, .xlsx, .xlsm, .xlsb) и OpenDocument (.ods).

Изменено в версии 1.2.0: Движок xlrd теперь поддерживает только старые файлы .xls. Когда engine=None, будет использована следующая логика для определения движка:

• Если path_or_buffer представляет собой формат OpenDocument (.odf, .ods, .odt), тогда будет использован odf.

• В противном случае, если path_or_buffer представляет собой формат xls, будет использован xlrd.

• В противном случае, если path_or_buffer имеет формат xlsb, будет использован pyxlsb.

Добавлена в версии 1.3.0.

• В противном случае, если установлен openpyxl, то будет использован openpyxl.

• В противном случае, если установлен xlrd >= 2.0, будет поднята ошибка ValueError.

Предупреждение

Не следует сообщать об ошибках при использовании xlrd для чтения файлов .xlsx. Это не поддерживается, используйте вместо этого openpyxl.

engine_kwargs:dict, необязательно

Произвольные ключевые аргументы, передаваемые движку excel.

Примеры

>>> file = pd.ExcelFile('myfile.xlsx')  
>>> with pd.ExcelFile("myfile.xls") as xls:  
...     df1 = pd.read_excel(xls, "Sheet1")  

Атрибуты

book
sheet_names

Методы

close()	Закрывает io при необходимости
parse([sheet_name, header, names, ...])	Разбор указанного(ых) листа(ов) в DataFrame.