pandas.read_excel

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

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

Параметры:

io : строка, объект пути (pathlib.Path или py._path.local.LocalPath), объект типа «поток» файла, pandas ExcelFile или рабочая книга xlrd. Строка может быть URL-адресом. Допустимые схемы URL-адресов включают http, ftp, s3 и file. Для URL-адресов файлов ожидается хост. Например, локальный файл может быть file://localhost/path/to/workbook.xlsx sheet_name : строка, целое число, смешанный список строк/целых чисел или None, по умолчанию 0 Строки используются для имен листов, целые числа — для позиций листов с нумерацией от нуля. Списки строк/целых чисел используются для запроса нескольких листов. Установите None, чтобы получить все листы. str|int -> возвращается DataFrame. list|None -> возвращается словарь DataFrame, где ключи представляют листы. Доступные варианты По умолчанию 0 -> 1-й лист в виде DataFrame 1 -> 2-й лист в виде DataFrame “Лист1” -> 1-й лист в виде DataFrame [0,1,”Лист5”] -> 1-й, 2-й и 5-й листы в виде словаря DataFrame None -> все листы в виде словаря DataFrame sheetname : строка, целое число, смешанный список строк/целых чисел или None, по умолчанию 0 Устаревшая с версии 0.21.0: Используйте sheet_name вместо этого. header : целое число, список целых чисел, по умолчанию 0 Строка (индексируется с 0) для использования в качестве меток столбцов анализируемого DataFrame. Если передан список целых чисел, эти позиции строк будут объединены в MultiIndex. Используйте None, если заголовка нет. skiprows : список Строки, которые нужно пропустить в начале (индексируются с 0) skip_footer : целое число, по умолчанию 0 Строки в конце, которые нужно пропустить (индексируются с 0) index_col : целое число, список целых чисел, по умолчанию None Столбец (индексируется с 0) для использования в качестве меток строк DataFrame. Передайте None, если такого столбца нет. Если передан список, эти столбцы будут объединены в MultiIndex. Если выбран подмножество данных с помощью usecols, index_col основывается на подмножестве. names : массив, по умолчанию None Список имен столбцов для использования. Если файл не содержит строки заголовков, необходимо явно передать header=None converters : словарь, по умолчанию None Словарь функций для преобразования значений в определенных столбцах. Ключи могут быть целыми числами или метками столбцов, значения — это функции, которые принимают один входной аргумент, содержимое ячейки Excel, и возвращают преобразованное содержимое. dtype : имя типа или словарь столбец -> тип, по умолчанию None Тип данных для данных или столбцов. Например, {‘a’: np.float64, ‘b’: np.int32} Используйте object для сохранения данных, как они хранятся в Excel, и не интерпретируйте dtype. Если заданы преобразователи, они будут применены ВМЕСТО преобразования типа данных. Новое в версии 0.20.0. true_values : список, по умолчанию None Значения, которые следует рассматривать как True Новое в версии 0.19.0. false_values : список, по умолчанию None Значения, которые следует рассматривать как False Новое в версии 0.19.0. parse_cols : целое число или список, по умолчанию None Устаревшая с версии 0.21.0: Передайте usecols вместо этого. usecols : целое число или список, по умолчанию None Если None, то анализируются все столбцы, Если целое число, то указывает последний столбец для анализа Если список целых чисел, то указывает список номеров столбцов для анализа Если строка, то указывает список столбцов в формате Excel (например, «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’, ‘n/a’, ‘nan’, ‘null’. thousands : строка, по умолчанию None Разделитель тысяч для преобразования строковых столбцов в числовые. Обратите внимание, что этот параметр необходим только для столбцов, хранящихся как TEXT в Excel; числовые столбцы будут автоматически анализироваться независимо от формата отображения. 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 хранит все числа как числа с плавающей запятой во внутренней форме

Возвращает:

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