一、xlrd模塊介紹
- xlrd是讀取excel表格數(shù)據(jù);
- 支持 xlsx和xls 格式的excel表格;
- 三方模塊安裝方式:pip3 install xlrd;
- 模塊導(dǎo)入方式: import xlrd
二、xlrd模塊操作
1. 基本函數(shù)
1.1. 打開workbook獲取Book對象
- xlrd.open_workbook(filename[, logfile, file_contents, ...]):打開excel文件
filename:需操作的文件名(包括文件路徑和文件名稱);
若filename不存在,則報(bào)錯(cuò)FileNotFoundError;
若filename存在,則返回值為xlrd.book.Book對象
1.2. 獲取Book對象中所有sheet名稱
- BookObject.sheet_names():獲取所有sheet的名稱,以列表方式顯示
1.3. 獲取Book對象中所有Sheet對象
BookObject.sheets():獲取所有sheet的對象,以列表形式顯示
BookObject.sheet_by_index(sheetx):通過sheet索引獲取所需sheet對象
sheetx為索引值,索引從0開始計(jì)算;
若sheetx超出索引范圍,則報(bào)錯(cuò)IndexError;
若sheetx在索引范圍內(nèi),則返回值為xlrd.sheet.Sheet對象BookObject.sheet_by_name(sheet_name):通過sheet名稱獲取所需sheet對象
sheet_name為sheet名稱;
若sheet_name不存在,則報(bào)錯(cuò)xlrd.biffh.XLRDError;
若sheet_name存在,則返回值為xlrd.sheet.Sheet對象
1.4. 判斷Book對象中某個(gè)sheet是否導(dǎo)入
- BookObject.sheet_loaded(sheet_name_or_index):通過sheet名稱或索引判斷該sheet是否導(dǎo)入成功
返回值為bool類型,若返回值為True表示已導(dǎo)入;若返回值為False表示未導(dǎo)入
1.5. 對Sheet對象中的行操作
SheetObject.nrows:獲取某sheet中的有效行數(shù)
SheetObject.row_values(rowx[, start_colx=0, end_colx=None]):獲取sheet中第rowx+1行從start_colx列到end_colx列的數(shù)據(jù),返回值為列表。
若rowx在索引范圍內(nèi),以列表形式返回?cái)?shù)據(jù);
若rowx不在索引范圍內(nèi),則報(bào)錯(cuò)IndexErrorSheetObject.row(rowx):獲取sheet中第rowx+1行單元,返回值為列表;
列表每個(gè)值內(nèi)容為: 單元類型:單元數(shù)據(jù)SheetObject.row_slice(rowx[, start_colx=0, end_colx=None]):以切片方式獲取sheet中第rowx+1行從start_colx列到end_colx列的單元,返回值為列表;
列表每個(gè)值內(nèi)容為: 單元類型:單元數(shù)據(jù)SheetObject.row_types(rowx[, start_colx=0, end_colx=None]):獲取sheet中第rowx+1行從start_colx列到end_colx列的單元類型,返回值為array.array類型。
單元類型ctype:empty為0,string為1,number為2,date為3,boolean為4, error為5(左邊為類型,右邊為類型對應(yīng)的值);SheetObject.row_len(rowx):獲取sheet中第rowx+1行的長度
rowx:行標(biāo),行數(shù)從0開始計(jì)算(0表示第一行), 必填參數(shù);
start_colx:起始列,表示從start_colx列開始取值,包括第start_colx的值;
end_colx:結(jié)束列,表示到end_colx列結(jié)束取值,不包括第end_colx的值;
start_colx默認(rèn)為0,end_colx默認(rèn)為None:表示取整行相關(guān)數(shù)據(jù);
- SheetObject.get_rows():獲取某一sheet所有行的生成器
1.6. 對Sheet對象中的列操作
SheetObject.ncols:獲取某sheet中的有效列數(shù)
SheetObject.col_values(self, colx[, start_rowx=0, end_rowx=None]):獲取sheet中第colx+1列從start_rowx行到end_rowx行的數(shù)據(jù),返回值為列表。
SheetObject.col_slice(colx[, start_rowx=0, end_rowx=None]):以切片方式獲取sheet中第colx+1列從start_rowx行到end_rowx行的數(shù)據(jù),返回值為列表。
列表每個(gè)值內(nèi)容為: 單元類型:單元數(shù)據(jù)SheetObject.col_types(colx[, start_rowx=0, end_rowx=None]):獲取sheet中第colx+1列從start_rowx行到end_rowx行的單元類型,返回值為列表;
1.7. 對Sheet對象的單元格執(zhí)行操作
ShellObeject.cell(rowx, colx):獲取sheet對象中第rowx+1行,第colx+1列的單元對象,返回值為'xlrd.sheet.Cell'類型,返回值的格式為“單元類型:單元值”。
ShellObject.cell_value(rowx, colx):獲取sheet對象中第rowx+1行,第colx+1列的單元數(shù)據(jù),返回值為當(dāng)前值的類型(如float、int、string...);
ShellObject.cell_type(rowx, colx):獲取sheet對象中第rowx+1行,第colx+1列的單元數(shù)據(jù)類型值;
單元類型ctype:empty為0,string為1,number為2,date為3,boolean為4, error為5;
import xlrd
""" 打開excel表格"""
workbook = xlrd.open_workbook("測試.xlsx")
print(workbook) # 結(jié)果:<xlrd.book.Book object at 0x000000000291B128>
""" 獲取所有sheet名稱"""
sheet_names = workbook.sheet_names()
print(sheet_names) # 結(jié)果:['表1', 'Sheet2']
""" 獲取所有或某個(gè)sheet對象"""
# 獲取所有的sheet對象
sheets_object = workbook.sheets()
print(sheets_object) # 結(jié)果:[<xlrd.sheet.Sheet object at 0x0000000002956710>, <xlrd.sheet.Sheet object at 0x0000000002956AC8>]
# 通過index獲取第一個(gè)sheet對象
sheet1_object = workbook.sheet_by_index(0)
print(sheet1_object) # 結(jié)果:<xlrd.sheet.Sheet object at 0x0000000002956710>
# 通過name獲取第一個(gè)sheet對象
sheet1_object = workbook.sheet_by_name(sheet_name="表1")
print(sheet1_object) # 結(jié)果:<xlrd.sheet.Sheet object at 0x0000000002956710>
""" 判斷某個(gè)sheet是否已導(dǎo)入"""
# 通過index判斷sheet1是否導(dǎo)入
sheet1_is_load = workbook.sheet_loaded(sheet_name_or_index=0)
print(sheet1_is_load) # 結(jié)果:True
# 通過sheet名稱判斷sheet1是否導(dǎo)入
sheet1_is_load = workbook.sheet_loaded(sheet_name_or_index="表1")
print(sheet1_is_load) # 結(jié)果:True
""" 對sheet對象中的行執(zhí)行操作:如有效行數(shù)、某行從n1到n2列的數(shù)據(jù)、某行的單元和類型、某行的長度...... """
# 獲取sheet1中的有效行數(shù)
nrows = sheet1_object.nrows
print(nrows) # 結(jié)果:5
# 獲取sheet1中第3行的數(shù)據(jù)
all_row_values = sheet1_object.row_values(rowx=2)
print(all_row_values) # 結(jié)果:[3.0, 'b', 1, '']
row_values = sheet1_object.row_values(rowx=2, start_colx=1, end_colx=3)
print(row_values) # 結(jié)果:['b', 1]
# 獲取sheet1中第3行的單元對象
row_object = sheet1_object.row(rowx=2)
print(row_object) # 結(jié)果:[number:3.0, text:'b', bool:1, empty:'']
# 獲取sheet1中第3行的單元
row_slice = sheet1_object.row_slice(rowx=2)
print(row_slice) # 結(jié)果:[number:3.0, text:'b', bool:1, empty:'']
# 獲取sheet1中第3行的單元類型
row_types = sheet1_object.row_types(rowx=2)
print(row_types) # 結(jié)果:array('B', [2, 1, 4, 0])
# 獲取sheet1中第3行的長度
row_len = sheet1_object.row_len(rowx=2)
print(row_len) # 結(jié)果:4
# 獲取sheet1所有行的生成器
rows_generator = sheet1_object.get_rows()
print(rows_generator) # 結(jié)果:<generator object Sheet.get_rows.<locals>.<genexpr> at 0x00000000028D8BA0>
""" 對sheet對象中的列執(zhí)行操作:"""
# 獲取sheet1中的有效列數(shù)
ncols = sheet1_object.ncols
print(ncols) # 結(jié)果:4
# 獲取sheet1中第colx+1列的數(shù)據(jù)
col_values = sheet1_object.col_values(colx=1)
print(col_values) # 結(jié)果:['測試', 'a', 'b', 'c', 'd']
col_values1 = sheet1_object.col_values(1, 1, 3)
print(col_values1) # 結(jié)果:['a', 'b']
# 獲取sheet1中第2列的單元
col_slice = sheet1_object.col_slice(colx=1)
print(col_slice) # 結(jié)果:[text:'測試', text:'a', text:'b', text:'c', text:'d']
# 獲取sheet1中第2列的單元類型
col_types = sheet1_object.col_types(colx=1)
print(col_types) # 結(jié)果:[1, 1, 1, 1, 1]
"""對sheet對象中的單元執(zhí)行操作"""
# 獲取sheet1中第rowx+1行,第colx+1列的單元對象
cell_info = sheet1_object.cell(rowx=1, colx=2)
print(cell_info) # 結(jié)果: text:'m'
print(type(cell_info)) # 結(jié)果:<class 'xlrd.sheet.Cell'>
# 獲取sheet1中第rowx+1行,第colx+1列的單元值
cell_value = sheet1_object.cell_value(rowx=1, colx=2)
print(cell_value) # 結(jié)果: m
# 獲取sheet1中第rowx+1行,第colx+1列的單元類型值
cell_type = sheet1_object.cell_type(rowx=1, colx=2)
print(cell_type) # 結(jié)果:1
2. 讀取單元格內(nèi)容為日期/時(shí)間的方式
若單元格內(nèi)容的類型為date,即ctype值為3時(shí),則代表此單元格的數(shù)據(jù)為日期
- xlrd.xldate_as_tuple(xldate, datemode):若xldate數(shù)據(jù)為日期/時(shí)間,則將轉(zhuǎn)化為適用于datetime的元組;
返回值為元組,格式為:(year, month, day, hour, minute, nearest_second)
xldate:sheet對象中單元格的數(shù)據(jù)
datemode:日期模式
""" 讀取sheet對象中的日期 """
import datetime
workbook = xlrd.open_workbook("測試.xlsx")
sheet2_object = workbook.sheet_by_name("Sheet2")
# value_type = sheet2_object.cell(0, 1).ctype
value_type = sheet2_object.cell_type(0, 1)
print(value_type) # 結(jié)果:3
if value_type == 3:
print("單元格數(shù)據(jù)為日期")
cell_value = sheet2_object.cell_value(0, 1)
print(cell_value) # 結(jié)果:43506.0
date_tuple = xlrd.xldate_as_tuple(cell_value, workbook.datemode)
print(date_tuple) # 結(jié)果:(2019, 2, 10, 0, 0, 0)
date_value = datetime.date(*date_tuple[:3])
print(date_value) # 結(jié)果:2019-02-10
date_format = date_value.strftime('%Y/%m/%d')
print(date_format) # 結(jié)果:2019/02/10
3. 對合并單元格執(zhí)行操作
(1) 獲取合并的單元格
若表格為xls格式的,打開workbook時(shí)需將formatting_info設(shè)置為True,然后再獲取sheet中的合并單元格;
若表格有xlsx格式的,打開workbook時(shí)保持formatting_info為默認(rèn)值False,然后再獲取sheet中的合并單元格;
- SheetObject.merged_cells:獲取sheet中合并單元格的信息,返回值為列表;
若sheet對象中無合并單元格,則返回值為空列表;
列表中每個(gè)單元格信息的格式為:(row_start, row_end, col_start, col_end)
row_start表示合并單元格的起始行;
row_end表示合并單元格的結(jié)束行;
col_start表示合并單元格的起始列;
col_end表示合并單元格的結(jié)束列;
合并單元格的行取值范圍為[row_start, row_end),包括row_start,不包括row_end;
合并單元格的列取值范圍為[col_start, col_end),包括col_start,不包括col_end;
如:(1, 3, 4, 6):表示從第1到2行合并,從第4到第5列合并;
(2)讀取合并單元格的數(shù)據(jù)
讀取合并單元格數(shù)據(jù)僅需merged_cells數(shù)據(jù)中的row_start和col_start這兩個(gè)索引即可
- SheetObject.cell_value(rowx=row_start, colx=col_start):獲取合并單元格的數(shù)據(jù)
""" 獲取合并的單元格并讀取單元格數(shù)據(jù) """
# 獲取xlsx格式的excel文件中的合并單元格
workbook = xlrd.open_workbook("測試.xlsx")
sheet2_object = workbook.sheet_by_name("Sheet2")
print(sheet2_object.merged_cells) # 結(jié)果: [(1, 2, 0, 2), (3, 6, 0, 2)]
# 獲取xls格式的excel文件中的合并單元格
workbook1 = xlrd.open_workbook("測試.xls", formatting_info=True)
sheet2_object1 = workbook1.sheet_by_name("Sheet2")
print(sheet2_object1.merged_cells) # 結(jié)果: [(1, 2, 0, 2), (3, 6, 0, 2)]
# 讀取合并單元格數(shù)據(jù)(僅需“起始行起始列”即可獲取數(shù)據(jù))
print(sheet2_object.cell_value(1, 0)) # 結(jié)果:合并
print(sheet2_object.cell_value(3, 0)) # 結(jié)果:合并2
# 或使用for循環(huán)獲取所有的合并單元格數(shù)據(jù)
for (row_start, row_end, col_start, col_end) in sheet2_object.merged_cells:
print(sheet2_object.cell_value(rowx=row_start, colx=col_start))