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 в pandas DataFrame

Параметры:

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 -> возвращается словарь DataFrames с ключами, представляющими листы. Доступные случаи По умолчанию 0 -> 1-й лист в виде DataFrame 1 -> 2-й лист в виде DataFrame “Лист1” -> 1-й лист в виде DataFrame [0,1,”Лист5”] -> 1-й, 2-й и 5-й листы в виде словаря DataFrames None -> все листы в виде словаря DataFrames 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. Если указаны converters, они будут применены ВМЕСТО преобразования 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 или словарь DataFrames DataFrame из переданного файла Excel. См. примечания в аргументе sheet_name для получения дополнительной информации о том, когда возвращается словарь DataFrames.