openpyxl3.0.3 中文手册--简单样例

 约 5 分钟

简单样例

写工作簿

from openpyxl import Workbook
from openpyxl.utils import get_column_letter

wb = Workbook()
dest_filename = 'empty_book.xlsx'
ws1 = wb.active
ws1.title = "range names"

for row in range(1, 40):
    ws1.append(range(600))

ws2 = wb.create_sheet(title="Pi")
ws2['F5'] = 3.14

ws3 = wb.create_sheet(title="Data")
for row in range(10, 20):
    for col in range(27, 54):
        _ = ws3.cell(column=col, row=row, value="0}".format(get_column_letter(col)))
print(ws3['AA10'].value)

输出结果:
AA

wb.save(filename = dest_filename)

读取现有的工作簿

from openpyxl import load_workbook

wb = load_workbook(filename = 'empty_book.xlsx')
sheet_ranges = wb['range names']
print(sheet_ranges['D18'].value)

输出结果:
3

注:在使用 load_workbook()读取工作薄时有几个标志(flag)以使用:
    data_only 控制带有公式的单元格是否具有公式(默认)或上一次Excel读取工作表时存储的值。
    keep_vba 控制是否保留 Visual Basic 元素(默认),如果保留,它们仍然是不可编辑的。
    
警告:openpyxl 当前无法读取 Excel 文件中的所有可能项目,因此如果打开已存在的文件
    并使用相同的文件名保存,那么图像和图表将从现有文件中丢失。

使用数字格式

import datetime
from openpyxl import Workbook

wb = Workbook()
ws = wb.active
# 使用 Python datetime 设置日期
ws['A1'] = datetime.datetime(2010, 7, 21)

ws['A1'].number_format
'yyyy-mm-dd h:mm:ss'

使用函数

from openpyxl import Workbook

wb = Workbook()
ws = wb.active
# 使用一个简单的函数
ws["A1"] = "=SUM(1, 1)"
wb.save("formula.xlsx")

注:函数必须使用英文名称,并且函数参数必须用逗号分隔,而不能使用其他标点符号,例如分号。

openpyxl 从不评估函数,但是可以检查函数的名称:

from openpyxl.utils import FORMULAE

"HEX2DEC" in FORMULAE

输出结果:
True

如果尝试使用未知的函数,可能是因为函数中未包含在初始规范中, 此类函数必须以 _xlfn 为前缀才会有效。

合并/拆分单元格

合并单元格时,除左上角单元格外,所有单元格都将从工作表中删除。为了携带合并单元格的边界信息,将合并单元格的边界单元格创建为MergeCells,它们的值始终为 None 。有关设置合并单元格的格式信息,请参阅设置合并单元格的样式。

from openpyxl.workbook import Workbook

wb = Workbook()
ws = wb.active

ws.merge_cells('A2:D2')
ws.unmerge_cells('A2:D2')

# 等同于
ws.merge_cells(start_row=2, start_column=1, end_row=4, end_column=4)
ws.unmerge_cells(start_row=2, start_column=1, end_row=4, end_column=4)

插入图像

from openpyxl import Workbook
from openpyxl.drawing.image import Image

wb = Workbook()
ws = wb.active
ws['A1'] = 'You should see three logos below'

# 创建图像对象
img = Image('logo.png')

# 添加到工作表并锚定在单元格
ws.add_image(img, 'A1')
wb.save('logo.xlsx')

隐藏单元格

import openpyxl

wb = openpyxl.Workbook()
ws = wb.create_sheet()
# 隐藏 A 到 D 列范围内的列
ws.column_dimensions.group('A','D', hidden=True)
# 隐藏 1 到 10 行范围内的行
ws.row_dimensions.group(1,10, hidden=True)
wb.save('group.xlsx')
阅读 225

推荐阅读
目录