pandas.read_excel

pandas.read_excel(io, sheetname=0, header=0, skiprows=None, skip_footer=0, index_col=None, names=None, parse_cols=None, parse_dates=False, date_parser=None, na_values=None, thousands=None, convert_float=True, has_index_names=None, converters=None, true_values=None, false_values=None, engine=None, squeeze=False, **kwds) [source]

Чтение таблицы Excel в pandas DataFrame

Параметры:

io : строка, объект пути (pathlib.Path или py._path.local.LocalPath), объект типа «поток» (file-like object), pandas ExcelFile или рабочая книга xlrd. Строка может быть URL-адресом. Поддерживаются схемы URL, такие как http, ftp, s3 и file. Для URL-адресов файлов ожидается хост. Например, локальный файл может быть file://localhost/path/to/workbook.xlsx sheetname : строка, целое число, смешанный список строк/целых чисел или None, по умолчанию 0 Строки используются для имен листов, целые числа — для позиций листов с нумерацией с нуля. Списки строк/целых чисел используются для запроса нескольких листов. Укажите None, чтобы получить все листы. str|int -> возвращается DataFrame. list|None -> возвращается словарь DataFrames, ключи которого представляют листы. Возможные варианты: По умолчанию 0 -> 1-й лист в виде DataFrame 1 -> 2-й лист в виде DataFrame “Лист1” -> 1-й лист в виде DataFrame [0,1,”Лист5”] -> 1-й, 2-й и 5-й листы в виде словаря DataFrames None -> Все листы в виде словаря DataFrames header : целое число, список целых чисел, по умолчанию 0 Строка (с нумерацией с нуля) для использования в качестве меток столбцов анализируемого DataFrame. Если передан список целых чисел, эти позиции строк будут объединены в MultiIndex skiprows : список Строки, которые нужно пропустить в начале (с нумерацией с нуля) skip_footer : целое число, по умолчанию 0 Строки в конце, которые нужно пропустить (с нумерацией с нуля) index_col : целое число, список целых чисел, по умолчанию None Столбец (с нумерацией с нуля) для использования в качестве меток строк DataFrame. Передайте None, если такого столбца нет. Если передан список, эти столбцы будут объединены в MultiIndex names : массив, по умолчанию None Список имен столбцов для использования. Если файл не содержит заголовка строки, необходимо явно указать header=None converters : словарь, по умолчанию None Словарь функций для преобразования значений в определенных столбцах. Ключи могут быть целыми числами или метками столбцов, значения — функциями, принимающими один аргумент — содержимое ячейки Excel, и возвращающими преобразованное содержимое. true_values : список, по умолчанию None Значения, которые нужно рассматривать как True Новое в версии 0.19.0. false_values : список, по умолчанию None Значения, которые нужно рассматривать как False Новое в версии 0.19.0. parse_cols : целое число или список, по умолчанию None Если None, то анализируются все столбцы, Если целое число, то обозначает последний столбец для анализа Если список целых чисел, то обозначает список номеров столбцов для анализа Если строка, то обозначает список имен столбцов и диапазонов столбцов, разделенных запятыми (например, “A:E” или “A,C,E:F”) squeeze : логическое значение, по умолчанию False Если анализируемые данные содержат только один столбец, возвращается Series na_values : скаляр, строка, список или словарь, по умолчанию None Дополнительные строки, распознаваемые как NA/NaN. Если передан словарь, то NA-значения специфичны для каждого столбца. По умолчанию следующие значения интерпретируются как NaN: ‘’, ‘#N/A’, ‘#N/A N/A’, ‘#NA’, ‘-1.#IND’, ‘-1.#QNAN’, ‘-NaN’, ‘-nan’, ‘1.#IND’, ‘1.#QNAN’, ‘N/A’, ‘NA’, ‘NULL’, ‘NaN’, ‘nan’. thousands : строка, по умолчанию None Разделитель тысяч для анализа столбцов со строковыми значениями до числовых. Обратите внимание, что этот параметр необходим только для столбцов, хранящихся в Excel как TEXT, любые числовые столбцы будут автоматически проанализированы независимо от формата отображения. keep_default_na : логическое значение, по умолчанию True Если указаны na_values и keep_default_na — False, значения NaN по умолчанию переопределяются, в противном случае они добавляются. verbose : логическое значение, по умолчанию False Указывает количество значений NA, размещенных в нечисловых столбцах engine: строка, по умолчанию None Если io не является буфером или путем, это значение должно быть установлено для идентификации io. Допустимые значения — None или xlrd convert_float : логическое значение, по умолчанию True преобразует целые числа с плавающей точкой в целые числа (т.е., 1,0 -> 1). Если False, все числовые данные будут читаться как числа с плавающей точкой: Excel хранит все числа в виде чисел с плавающей точкой внутри has_index_names : логическое значение, по умолчанию None УСТАРЕЛО: для версии 0.17+ имена индексов будут автоматически определяться на основе index_col. Чтобы прочитать выходные данные Excel из 0.16.2 и более ранних версий, которые сохранили имена индексов, используйте True.

Возвращает:

parsed : DataFrame или словарь DataFrames DataFrame из переданного файла Excel. См. примечания в аргументе sheetname для получения дополнительной информации о том, когда возвращается словарь DataFrames.