xlrd - интсрумент для чтения xls фалйов¶
Для отладки и анализа: обобщить BIFF записи файла. Т.е. получаем отсортированный файл (запись, количесвто).
filename (str) – путь к файлу
outfile – объект для записи (должен иметь метод write) результатов
Для отладки, выгрузка BIFF записей в char и hex
filename (str) – путь к файлу
outfile – объект для записи (должен иметь метод write) результатов
unnumbered – опустить смещения
Открывает файл и возвращает объект xlrd.Book
filename (str) – путь к файлу
logfile – объект, для записи лог информации
verbosity – уровень логируемой информации
pickleable – что то связанное с использованием памяти, актуально для 2.4 и ниже. (Default is true. In Python 2.4 or earlier, setting to false will cause use of array.array objects which save some memory but can’t be pickled. In Python 2.5, array.arrays are used unconditionally. Note: if you have large files that you need to read multiple times, it can be much faster to cPickle.dump() the xlrd.Book object once, and use cPickle.load() multiple times.)
use_mmap – Whether to use the mmap module is determined heuristically. Use this arg to override the result. Current heuristic: mmap is used if it exists.
file_contents – as a string or an mmap.mmap object or some other behave-alike object. If file_contents is supplied, filename will not be used, except (possibly) in messages.
encoding_override – кодировка открываемого файла – New in version 0.6.0
formatting_info – Governs provision of a reference to an XF (eXtended Format) object for each cell in the worksheet. Default is False. This is backwards compatible and saves memory. “Blank” cells (those with their own formatting information but no data) are treated as empty (by ignoring the file’s BLANK and MULBLANK records). It cuts off any bottom “margin” of rows of empty (and blank) cells and any right “margin” of columns of empty (and blank) cells. Only cell_value and cell_type are available. True provides all cells, including empty and blank cells. XF information is available for each cell. – New in version 0.6.1
on_demand – управляет загрузкой листов. При открытии файла загружаются сразу все листы или листы будут загружены позже при необходимости.
ragged_rows – False (the default) means all rows are padded out with empty cells so that all rows have the same size (Sheet.ncols). True means that there are no empty cells at the ends of rows. This can result in substantial memory savings if rows are of widely varying sizes. See also the Sheet.row_len() method. – New in version 0.7.2
Ref3D((1, 4, 5, 20, 7, 10)) => ‘Sheet2:Sheet3!$H$6:$J$20’
xlrd. rangename3drel ( book, ref3d, browx=None, bcolx=None, r1c1=0 ) ¶
Ref3D(coords=(0, 1, -32, -22, -13, 13), relflags=(0, 0, 1, 1, 1, 1)) R1C1 mode => ‘Sheet1!R[-32]C[-13]:R[-23]C[12]’ A1 mode => depends on base cell (browx, bcolx)
xlrd. xldate_as_tuple ( xldate, datemode ) ¶
Преобразует дату из Excel формата в кортеж c датой (год, месяц, день, час, минута, секунды).
xldate – дата в Excel формате
datemode – 0: 1900-based, 1: 1904-based.
XLDateNegative – xldate < 0.00
XLDateAmbiguous – The 1900 leap-year problem (datemode == 0 and 1.0 <= xldate < 61.0)
XLDateTooLarge – Gregorian year 10000 or later
XLDateBadDatemode – datemode arg is neither 0 nor 1
XLDateError – Covers the 4 specific errors
when using this function to interpret the contents of a workbook, you should pass in the Book.datemode attribute of that workbook. Whether the workbook has ever been anywhere near a Macintosh is irrelevant.
1904-01-01 is not regarded as a valid date in the datemode 1 system; its “serial number” is zero.
Преобразует дату из кортежа, в формат даты Excel.
datemode – 0: 1900-based, 1: 1904-based.
XLDateAmbiguous – The 1900 leap-year problem (datemode == 0 and 1.0 <= xldate < 61.0)
XLDateBadDatemode – datemode arg is neither 0 nor 1
XLDateBadTuple – (year, month, day) is too early/late or has invalid component(s)
XLDateError – Covers the specific errors
Преобразует дату и время из кортежа в формат даты и времени Excel.
datemode – 0: 1900-based, 1: 1904-based.
xlrd. xldate_from_time_tuple ( (hour, minute, second) ) ¶
Преобразует время из кортежа, во время в формате Excel
XLDateBadTuple – Out-of-range hour, minute, or second
BaseObject¶
Родительсикй класс для других классов модуля
f – файловый объект для выгрузки дампа
header (str) – текс, записываемы в файл дампа перед дампом
footer (str) – текст, записываемый после дампа
indent (int) – количество пробелов, заменяющих табуляцию
Вы не можете создать экземпляры данного класса сами. Данный объект возвращает метод xlrd.open_workbook() .
Возвращает число, версию о BIFF (Binary Interchange File Format) используемый при создании файла. (Latest is 8.0 (represented here as 80), introduced with Excel 97. Earliest supported by this module: 2.0 (represented as 20).)
Возвращает число, кодировку файла. Для BIFF 8 и выше это будет 1200, что означает юникод (UTF_16_LE). Для более ранних версии, используется число натиболее подходящее кодировке Python, например 1252 -> ‘cp1252’, 10000 -> ‘mac_roman’.
Возвращает словарь, индексы цветов. Только если открывать книгу с атрибутом open_workbook(…, formatting_info=True)
Возвращает кортеж, содержащий код страны для
настройки пользовательского интерфейса
Например: (1, 61) meaning (USA, Australia).
Возвращает число, формат даты файла
=> 1900 system (the Excel for Windows default).
=> 1904 system (the Excel for Macintosh default).
Возврашает список экземпляров объекта xlrd.Font каждая из которых соответствует записи
Возвращает список экземпляров объекта xlrd.Format каждая из которых соответствует записи. It does not contain builtin formats. If you are creating an output file using (for example) pyExcelerator, use this list. The collection to be used for all visual rendering purposes is format_map.
Возвращает словарь, полученный путем связывания xlrd.XF.format_key с объектом xlrd.Format
Возвращает число, время в секундах извлеченич XLS образа в одну строку. (Time in seconds to extract the XLS image as a contiguous string (or mmap equivalent).)
Возвращает число, время в секундах разбора XLS образа. (Time in seconds to extract the XLS image as a contiguous string (or mmap equivalent).)
Возвращает словарь. (A mapping from (lower_case_name, scope) to a single Name object.)
A mapping from lower_case_name to a list of Name objects. The list is sorted in scope order. Typically there will be one item (of global scope) in the list.
Возвращает список, содержит объект xlrd.Name для каждой записи книги
Возвращает число, количество листов в книге
Возвращает список. Если пользователь изменил любой из цветов в стандартной палитре, файл XLS будет содержать запись Палитра с 56 (16 для Excel 4.0 и ранее) значения RGB в нем, и этот список будет, например, [(r0, b0, g0 ), …, (r55, b55, g55)]. В противном случае этот список будет пустым. Это то, что вам нужно, если вы пишете файл XLS выходной. Если вы хотите сделать клетки на экране или в PDF файле, используйте colour_map. Книга должна быть открыта с параметром xlrd.open_workbook(. formatting_info=True)()
(If the user has changed any of the colours in the standard palette, the XLS file will contain a PALETTE record with 56 (16 for Excel 4.0 and earlier) RGB values in it, and this list will be e.g. [(r0, b0, g0), …, (r55, b55, g55)]. Otherwise this list will be empty. This is what you need if you are writing an output XLS file. If you want to render cells on screen or in a PDF file, use colour_map.)
Extracted only if open_workbook(…, formatting_info=True)
Возвращает строку, автора, который последним изменил файл.
Возвращает список объектов, экземпляров класса xlrd.XF соответствующих каждой записи XF
Возвращает словарь. This provides access via name to the extended format information for both built-in styles and user-defined styles. It maps name to (built_in, xf_index), where: name is either the name of a user-defined style, or the name of one of the built-in styles. Known built-in names are Normal, RowLevel_1 to RowLevel_7, ColLevel_1 to ColLevel_7, Comma, Currency, Percent, “Comma [0]”, “Currency [0]”, Hyperlink, and “Followed Hyperlink”. built_in 1 = built-in style, 0 = user-defined xf_index is an index into Book.xf_list. References: OOo docs s6.99 (STYLE record); Excel UI Format/Style
Данный метод имеет двойное предназначение.
Вы можете вызвать данный метод для освобождения памяти, после загрузки необходимого листа.
Также данный метод вызывается автоматический:
когда open_workbook вызывает исключение
если вы используете оператор with()
Возвращает лист книги по индексу, экземпляр класса xlrd.Sheet
sheetx (int) – индекс листа
Возвращает лист книги по наименованию, экземпляр класса xlrd.Sheet
sheet_name (str) – название листа
Возвращает True|False, загружен ли лист
sheet_name_or_index (int, str) – индекс или название листа
Возвращает список названий листов книги.
Возвращает список листов книги, экземпляров xlrd.Sheet .
Выгружает указанный лист.
sheet_name_or_index (int, str) – индекс или название листа
Объект “Ячейка”, содержит информацию об одной ячейке
вы не сможете создать этот класс самостоятельно. Данный объект возвращается только методами объекта xlrd.Sheet
ctype (int) –
value – зависит от ctype
xf_index – None, если “formatting_info” не включен при открытии книги