教程¶
创建工作簿¶
无需在文件系统上创建文件即可开始使用OpenPYXL。只导入 Workbook
上课开始工作:
>>> from openpyxl import Workbook
>>> wb = Workbook()
一个工作簿总是至少创建一个工作表。你可以通过使用 Workbook.active
属性:
>>> ws = wb.active
注解
默认设置为0。除非修改其值,否则使用此方法将始终获取第一个工作表。
可以使用创建新工作表 Workbook.create_sheet()
方法:
>>> 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
创建图纸时,会自动为其命名。它们按顺序编号(Sheet,Sheet1,Sheet2,…)。您可以随时使用 Worksheet.title
属性:
ws.title = "New Title"
默认情况下,包含此标题的选项卡的背景色为白色。您可以通过提供 RRGGBB
颜色代码到 Worksheet.sheet_properties.tabColor
属性:
ws.sheet_properties.tabColor = "1072BA"
为工作表命名后,可以将其作为工作簿的键:
>>> ws3 = wb["New Title"]
您可以使用 Workbook.sheetname
属性:
>>> print(wb.sheetnames)
['Sheet2', 'New Title', 'Sheet1']
您可以循环浏览工作表:
>>> for sheet in wb:
... print(sheet.title)
可以创建工作表的副本 在单个工作簿中 :
Workbook.copy_worksheet()
方法:
>>> source = wb.active
>>> target = wb.copy_worksheet(source)
注解
只复制单元格(包括值、样式、超链接和注释)和某些工作表属性(包括尺寸、格式和属性)。不复制所有其他工作簿/工作表属性-例如图像、图表。
你也 不能 在工作簿之间复制工作表。如果工作簿在中打开,则无法复制工作表 read-only 或 write-only 模式。
玩数据游戏¶
访问一个单元¶
现在我们知道了如何获取工作表,我们可以开始修改单元格内容。单元格可以作为工作表的键直接访问::
>>> c = ws['A4']
这将返回A4处的单元格,或者在还不存在的情况下创建一个单元格。可直接分配值:
>>> ws['A4'] = 4
还有 Worksheet.cell()
方法。
这提供了对使用行和列表示法的单元格的访问:
>>> d = ws.cell(row=4, column=2, value=10)
注解
在内存中创建工作表时,它不包含 cells . 它们是在首次访问时创建的。
警告
由于这个特性,滚动单元格而不是直接访问单元格,将在内存中创建所有单元格,即使您没有给它们赋值。
比如:
>>> for x in range(1,101):
... for y in range(1,101):
... ws.cell(row=x, column=y)
将在内存中创建100x100个单元格,不需要任何操作。
访问多个单元格¶
可以使用切片访问单元格区域::
>>> 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 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
属性在只读模式下不可用。
仅值¶
如果只需要工作表中的值,可以使用 Worksheet.values
财产。这将迭代工作表中的所有行,但只返回单元格值:
for row in ws.values:
for value in row:
print(value)
两个 Worksheet.iter_rows()
和 Worksheet.iter_cols()
可以采取 values_only
仅返回单元格值的参数:
>>> 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)
数据存储¶
一旦我们拥有了 Cell
,我们可以给它赋值:
>>> c.value = 'hello, world'
>>> print(c.value)
'hello, world'
>>> d.value = 3.14
>>> print(d.value)
3.14
保存到文件¶
保存工作簿的最简单和最安全的方法是使用 Workbook.save()
方法 Workbook
对象:
>>> wb = Workbook()
>>> wb.save('balances.xlsx')
警告
此操作将覆盖现有文件而不发出警告。
注解
文件扩展名不强制为XLSX或XLSM,但是如果不使用正式扩展名,您可能无法直接用另一个应用程序打开它。
由于ooxml文件基本上是zip文件,所以您也可以使用最喜欢的zip存档管理器打开它。
保存为流¶
如果要将文件保存到流中,例如在使用金字塔、Flask或Django等Web应用程序时,只需提供 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')
或将此属性设置为 False (默认),保存为文档:
>>> wb = load_workbook('document_template.xltx')
>>> wb.template = False
>>> wb.save('document.xlsx', as_template=False)
警告
您应该监视数据属性和文档扩展名,以便在文档模板中保存文档,反之亦然,否则结果表引擎无法打开文档。
注解
以下操作将失败:
>>> 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
从文件加载¶
和写作一样,你可以使用 openpyxl.load_workbook()
打开现有工作簿:
>>> from openpyxl import load_workbook
>>> wb2 = load_workbook('test.xlsx')
>>> print wb2.sheetnames
['Sheet2', 'New Title', 'Sheet1']
本教程到此结束,您可以继续 简单用法 部分