創(chuàng)建工作簿?
在使用openpyxl庫(kù)時(shí)疏尿,無(wú)需創(chuàng)建一個(gè)空白的Excel文件榆鼠。只需要導(dǎo)入Workbook
類(lèi):
>>> from openpyxl import Workbook
>>> wb = Workbook()
在Excel工作簿中至少包含一個(gè)工作表震鹉【愕眩可以通過(guò)Workbook.active
屬性來(lái)獲取當(dāng)前活動(dòng)工作表:
>>> ws = wb.active
active屬性默認(rèn)為0。在未重新賦值情況下传趾,可以使用此方法獲得第一個(gè)工作表迎膜。
可以使用Workbook.create_sheet()
方法來(lái)創(chuàng)建新的工作表:
>>> ws1 = wb.create_sheet("Mysheet") # insert at the end (default)
# or
>>> ws2 = wb.create_sheet("Mysheet", 0) # insert at first position
# or
>>> ws3 = wb.create_sheet("Mysheet", -1) # insert at the penultimate position
如果新建表名相同,在創(chuàng)建時(shí)將自動(dòng)按數(shù)字命名浆兰,例如Sheet, Sheet1, Sheet2磕仅。可以在任何時(shí)刻通過(guò)Worksheet.title
屬性來(lái)修改名稱:
ws.title = "New Title"
包含此標(biāo)題的工作表標(biāo)簽的默認(rèn)背景顏色為白色簸呈¢哦可以將新的RRGGBB
值賦值給Worksheet.sheet_properties.tabColor
屬性來(lái)修改顏色:
ws.sheet_properties.tabColor = "1072BA"
在給工作表命名后,你就可以使用該名字作為工作簿的一個(gè)鍵來(lái)獲取工作表:
>>> ws3 = wb["New Title"]
可以通過(guò)Workbook.sheetname
屬性來(lái)獲取所有的工作表名稱:
>>> print(wb.sheetnames)
['Sheet2', 'New Title', 'Sheet1']
您可以使用for
循環(huán)遍歷所有的工作表:
>>> for sheet in wb:
... print(sheet.title)
可以使用Workbook.copy_worksheet()
方法在同一個(gè)工作簿中創(chuàng)建工作表的副本:
>>> source = wb.active
>>> target = wb.copy_worksheet(source)
只有單元格(包括值蜕便、樣式劫恒、超鏈接和注釋)和某些工作表屬性(包括維度、格式和屬性)被復(fù)制轿腺。所有其他工作簿/工作表屬性不被復(fù)制两嘴,例如圖像、圖表族壳。
您也不能在工作簿之間復(fù)制工作表憔辫。如果工作簿是打開(kāi)的、只讀的或只寫(xiě)的仿荆,也不能復(fù)制工作表贰您。
處理數(shù)據(jù)?
訪問(wèn)一個(gè)單元格?
現(xiàn)在我們知道如何獲得工作表喧务,我們可以開(kāi)始修改單元格內(nèi)容⊥髌裕可以把單元格位置作為工作表的鍵直接訪問(wèn):
>>> c = ws['A4']
這將返回A4位置的單元格。如果不存在將創(chuàng)建單元格A4庐冯∧跚祝可以直接為單元格賦值:
>>> ws['A4'] = 4
Worksheet.cell()
方法可實(shí)現(xiàn)相同作用,該方法使用行和列值參數(shù)來(lái)訪問(wèn)單元格:
>>> d = ws.cell(row=4, column=2, value=10)
注解
在內(nèi)存中創(chuàng)建工作表時(shí)展父,它不包含“單元格”返劲。它們是第一次訪問(wèn)時(shí)創(chuàng)建的。
警告
由于這個(gè)特性栖茉,滾動(dòng)單元格而不是直接訪問(wèn)單元格將在內(nèi)存中創(chuàng)建所有單元格篮绿,即使您沒(méi)有給它們賦值。
比如:
>>> for x in range(1,101):
... for y in range(1,101):
... ws.cell(row=x, column=y)
將在內(nèi)存中創(chuàng)建100x100個(gè)單元格吕漂。
訪問(wèn)多個(gè)單元格?
可以使用切片訪問(wèn)單元格區(qū)域:
>>> cell_range = ws['A1':'C2']
可以單獨(dú)指定行或列的范圍:
>>> colC = ws['C']
>>> col_range = ws['C:D']
>>> row10 = ws[10]
>>> row_range = ws[5:10]
您也可以使用Worksheet.iter_rows()
方法:
>>> for row in ws.iter_rows(min_row=1, max_col=3, max_row=2):
... for cell in row:
... print(cell)
<Cell Sheet1.A1>
<Cell Sheet1.B1>
<Cell Sheet1.C1>
<Cell Sheet1.A2>
<Cell Sheet1.B2>
<Cell Sheet1.C2>
同樣的Worksheet.iter_cols()
方法將返回列:
>>> for col in ws.iter_cols(min_row=1, max_col=3, max_row=2):
... for cell in col:
... print(cell)
<Cell Sheet1.A1>
<Cell Sheet1.A2>
<Cell Sheet1.B1>
<Cell Sheet1.B2>
<Cell Sheet1.C1>
<Cell Sheet1.C2>
注解
出于性能原因亲配,Worksheet.iter_cols()
方法在只讀模式下不可用。
如果需要遍歷文件的所有行或列惶凝,可以使用Worksheet.rows
屬性:
>>> ws = wb.active
>>> ws['C9'] = 'hello world'
>>> tuple(ws.rows)
((<Cell Sheet.A1>, <Cell Sheet.B1>, <Cell Sheet.C1>),
(<Cell Sheet.A2>, <Cell Sheet.B2>, <Cell Sheet.C2>),
(<Cell Sheet.A3>, <Cell Sheet.B3>, <Cell Sheet.C3>),
(<Cell Sheet.A4>, <Cell Sheet.B4>, <Cell Sheet.C4>),
(<Cell Sheet.A5>, <Cell Sheet.B5>, <Cell Sheet.C5>),
(<Cell Sheet.A6>, <Cell Sheet.B6>, <Cell Sheet.C6>),
(<Cell Sheet.A7>, <Cell Sheet.B7>, <Cell Sheet.C7>),
(<Cell Sheet.A8>, <Cell Sheet.B8>, <Cell Sheet.C8>),
(<Cell Sheet.A9>, <Cell Sheet.B9>, <Cell Sheet.C9>))
或Worksheet.columns
屬性:
>>> tuple(ws.columns)
((<Cell Sheet.A1>,
<Cell Sheet.A2>,
<Cell Sheet.A3>,
<Cell Sheet.A4>,
<Cell Sheet.A5>,
<Cell Sheet.A6>,
...
<Cell Sheet.B7>,
<Cell Sheet.B8>,
<Cell Sheet.B9>),
(<Cell Sheet.C1>,
<Cell Sheet.C2>,
<Cell Sheet.C3>,
<Cell Sheet.C4>,
<Cell Sheet.C5>,
<Cell Sheet.C6>,
<Cell Sheet.C7>,
<Cell Sheet.C8>,
<Cell Sheet.C9>))
注解
出于性能原因吼虎,Worksheet.columns
屬性在只讀模式下不可用。
只包括數(shù)值?
如果只需要工作表中的值苍鲜,可以使用對(duì)象:obj:Worksheet.values
屬性思灰。這將遍歷工作表中的所有行,但只返回單元格值:
for row in ws.values:
for value in row:
print(value)
兩者Worksheet.iter_rows()
和Worksheet.iter_cols()
可以設(shè)置values_only
參數(shù)來(lái)僅返回單元格的值:
>>> for row in ws.iter_rows(min_row=1, max_col=3, max_row=2, values_only=True):
... print(row)
(None, None, None)
(None, None, None)
數(shù)據(jù)存儲(chǔ)?
當(dāng)我們有一個(gè)單元格類(lèi)Cell對(duì)象混滔,我們就可以給它賦值:
>>> c.value = 'hello, world'
>>> print(c.value)
'hello, world'
>>> d.value = 3.14
>>> print(d.value)
3.14
保存到文件?
保存工作簿最簡(jiǎn)單洒疚、最安全的方法是使用函數(shù)Workbook.save()
:
>>> wb = Workbook()
>>> wb.save('balances.xlsx')
警告
此操作將覆蓋現(xiàn)有文件而不發(fā)出警告。
注解
文件擴(kuò)展名不必是xlsx或xlsm坯屿,但如果不使用正式擴(kuò)展名油湖,則可能在使用其他應(yīng)用程序直接打開(kāi)文件時(shí)遇到一些問(wèn)題。
由于OOXML文件基本上是ZIP文件领跛,因此您還可以使用您喜愛(ài)的ZIP壓縮文檔管理器打開(kāi)它肺魁。
保存為流?
如果要將文件保存到流中,例如在使用網(wǎng)絡(luò)應(yīng)用程序(如Pyramid隔节、Flask或Django)鹅经,則只需提供NamedTemporaryFile()
:
>>> from tempfile import NamedTemporaryFile
>>> from openpyxl import Workbook
>>> wb = Workbook()
>>> with NamedTemporaryFile() as tmp:
wb.save(tmp.name)
tmp.seek(0)
stream = tmp.read()
可以指定template=True
屬性,將工作簿保存為模板:
>>> wb = load_workbook('document.xlsx')
>>> wb.template = True
>>> wb.save('document_template.xltx')
或?qū)⒋藢傩栽O(shè)置為“False”(默認(rèn)值)怎诫,以另存為文檔:
>>> wb = load_workbook('document_template.xltx')
>>> wb.template = False
>>> wb.save('document.xlsx', as_template=False)
警告
在在文檔模板中保存文檔時(shí)您應(yīng)該關(guān)注數(shù)據(jù)屬性和文檔擴(kuò)展是否正確瘾晃,反之亦然。否則無(wú)法打開(kāi)文檔幻妓。
注解
以下操作將失敱奈蟆:
>>> wb = load_workbook('document.xlsx')
>>> # Need to save with the extension *.xlsx
>>> wb.save('new_document.xlsm')
>>> # MS Excel can't open the document
>>>
>>> # or
>>>
>>> # Need specify attribute keep_vba=True
>>> wb = load_workbook('document.xlsm')
>>> wb.save('new_document.xlsm')
>>> # MS Excel will not open the document
>>>
>>> # or
>>>
>>> wb = load_workbook('document.xltm', keep_vba=True)
>>> # If we need a template document, then we must specify extension as *.xltm.
>>> wb.save('new_document.xlsm')
>>> # MS Excel will not open the document
從文件加載?
和寫(xiě)入Excel文件類(lèi)似劫拢,您可以使用openpyxl.load_workbook()
方法打開(kāi)現(xiàn)有工作簿:
>>> from openpyxl import load_workbook
>>> wb2 = load_workbook('test.xlsx')
>>> print wb2.sheetnames
['Sheet2', 'New Title', 'Sheet1']
本教程到此結(jié)束。
水平有限强胰,如果有朋友發(fā)現(xiàn)文中許多翻譯不當(dāng)?shù)牡胤讲詹祝?qǐng)隨時(shí)指正。
翻譯不易偶洋,也請(qǐng)大家多多點(diǎn)贊熟吏!