教程
創(chuàng)建工作薄
無需在文件系統(tǒng)上創(chuàng)建文件即可開始使用openpyxl。只需要導(dǎo)入Workbook課程并開始工作:
from openpyxl import Workbook
wb = Workbook()
始終使用至少一個(gè)工作表創(chuàng)建一個(gè)工作薄。您可以使用Workbook.active屬性來獲取它:
ws = wb.active
| 默認(rèn)情況下設(shè)置為0。除非您修改其值,否則將始終使用此方法獲得第一個(gè)工作表。 |
您可以使用以下Workbook.create_sheet()方法創(chuàng)建愛你新的工作表:
from openpyxl import Workbook
wb = Workbook()
ws1 = wb.create_sheet(title=str('MySheet')) # insert at the end(default)
ws2 = wb.create_sheet(title=str('MySheet'), index=0) # insert at first position
ws3 = wb.create_sheet(title=str('MySheet'), index=-1) # insert at penultimate position
在創(chuàng)建表單的時(shí)候會(huì)自動(dòng)為其命名。他們按順序編號(hào)(Sheet, Sheet1, Sheet2等)。您可以隨時(shí)通過Worksheet.title屬性更改此名稱。
from openpyxl import Workbook
wb = Workbook()
ws = wb.active
ws.title = "New Title"
默認(rèn)情況下, 包含該標(biāo)題的選項(xiàng)卡的背景顏色為白色。您可以更改此屬性RRGGBB, 為Worksheet.sheet_properties.tabColor屬性提供顏色代碼:
from openpyxl import Workbook
wb = Workbook()
ws = wb.active
ws.sheet_properties.tabColor = '1072BA'
給工作表命名后,就可以將其作為工作薄的鍵:
from openpyxl import Workbook
wb = Workbook()
ws = wb.active
ws3 = wb['New Title']
您可以使用Workbook.sheetname屬性查看工作薄中所有工作表的名稱
from openpyxl import Workbook
wb = Workbook()
print(wb.sheetnames) # ['Sheet2', 'New Title', 'Sheet1']
您可以遍歷工作表
from openpyxl import Workbook
wb = Workbook()
for sheet in wb:
print(sheet)
您可以在單個(gè)工作薄中創(chuàng)建工作表的副本:
Workbook.copy_worksheet()方法:
from openpyxl import Workbook
wb = Workbook()
source = wb.active
target = wb.copy_worksheet(source)
| 僅復(fù)制單元格(包括值,樣式,超鏈接和注釋)和某些工作表屬性(包括尺寸,格式和屬性)。不賦值所有其他工作薄/工作表屬性-例如圖像, 圖表。 您也不能在工作薄之間復(fù)制工作表。如果工作薄以只讀或** |
| 僅寫**模式打開, 則不能復(fù)制工作表 |
訪問一個(gè)單元
現(xiàn)在我們知道了如何獲得工作表,我們可以開始修改單元格的內(nèi)容了。單元格可以直接作為工作表的鍵進(jìn)行訪問:
from openpyxl import Workbook
wb = Workbook()
ws = wb.active
c = ws['A4']
這將返回A4處的單元格,或者如果尚未存在則創(chuàng)建一個(gè)單元格。可以直接分配值:
from openpyxl import Workbook
wb = Workbook()
ws = wb.active
ws['A4'] = 4
還有Worksheet.cell()方法。
這樣可以可以行和列表示法訪問單元格:
from openpyxl import Workbook
wb = Workbook()
ws = wb.active
d = ws.cell(row=4, column=2, value=10)
| 在內(nèi)存中創(chuàng)建工作表時(shí),它不包含任何單元格。他們是在首次訪問時(shí)創(chuàng)建的。 |
| 由于此功能,即時(shí)不為他們分配值, 也可以滾動(dòng)瀏覽而不是直接訪問它們將在內(nèi)存中全部創(chuàng)建他們。 |
訪問多個(gè)單元
可以使用切片訪問單元格范圍:
cell_range = ws['A1':'C2']
行或列的范圍可以類似的獲得:
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 Sheet.A1>
<Cell Sheet.B1>
<Cell Sheet.C1>
<Cell Sheet.A2>
<Cell Sheet.B2>
<Cell Sheet.C2>
"""
同樣,該Worksheet.iter_cols()方法將返回列:
for col in ws.iter_cols(min_row=1, max_col=3, max_col=2):
for cell in col:
print(cell)
"""
<Cell Sheet.A1>
<Cell Sheet.A2>
<Cell Sheet.B1>
<Cell Sheet.B2>
<Cell Sheet.C1>
<Cell Sheet.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.A7>,
<Cell Sheet.A8>,
<Cell Sheet.A9>),
...
(<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屬性在只讀模式在不可用 |
僅值
如果只需要工作表中的值,則可以使用該Workbook.values屬性。這將便利工作表中的所有行,但僅返回單元格值:
for row in ws.values:
for value in row:
print(value)
雙方Worksheet.iter_rows()并Workbook.iter_cols()可以采取的values_only參數(shù),只返回單元格的值:
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ǔ)
一旦有了Cell,, 我們就可以為其分配一個(gè)值:
v.value = 'hello, world'
print(c.value) # 'hello, world'
d.value = 3.14
print(d.value) # .314
保存到文件
保存工作薄的最簡(jiǎn)單,最安全的方法是使用對(duì)象的Workbook.save()方法:
wb = Workbook()
wb.save('balances.xlsx')
| 此操作將覆蓋現(xiàn)有文件,而不會(huì)發(fā)出警告 |
| 文件名擴(kuò)展名不是強(qiáng)制為xlsx或xlsm,盡管如果不使用正式擴(kuò)展名,則可能會(huì)直接在其他應(yīng)用程序中打開它,因此可能會(huì)遇到一些麻煩。 由于OOXML文件基本上是ZIP文件,因此您也可以使用自己喜歡的ZIP存檔管理器將其打開 |
另存為流 如果要將文件保存到流中,例如在使用WEB應(yīng)用程序(例如Pyramid,F(xiàn)lask或Django)時(shí),只需提供以下命令即可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.xlsx')
或?qū)⒋藢傩栽O(shè)置為False(默認(rèn)),以另存為文檔:
wb = load_workbook('document_template.xlsx')
wb.template = False
wb.save('document.xlsx', as_template=False)
| 您應(yīng)監(jiān)視數(shù)據(jù)屬性和文檔擴(kuò)展名以將文檔保存在文檔模板中,反之亦然,否則結(jié)果表引擎將無法打開文檔。 |
從文件加載
與書寫相同,您可以使用openpyxl.load_workbook()打開現(xiàn)有的工作?。?/p>
from openpyxl import load_workbook
wb2 =load_workdbook('test.xlsx')
print(wb2.sheetnames) # ['sheet2', 'New Title', 'Sheet1']