Python酷库之旅-第三方库openpyxl(18)

# ['DEBUG', 'DEFUSEDXML', 'LXML', 'NUMPY', 'Workbook', '__author__', '__author_email__', '__builtins__', '__cached__', 
# '__doc__', '__file__', '__license__', '__loader__', '__maintainer_email__', '__name__', '__package__', '__path__',
# '__spec__', '__url__', '__version__', '_constants', 'cell', 'chart', 'chartsheet', 'comments', 'compat', 'constants',
# 'descriptors', 'drawing', 'formatting', 'formula', 'load_workbook', 'open', 'packaging', 'pivot', 'reader', 'styles',
# 'utils', 'workbook', 'worksheet', 'writer', 'xml']

2、获取openpyxl库的帮助信息

用help()函数获取openpyxl库的帮助信息

Help on package openpyxl:

NAME
    openpyxl - # Copyright (c) 2010-2024 openpyxl

PACKAGE CONTENTS
    _constants
    cell (package)
    chart (package)
    chartsheet (package)
    comments (package)
    compat (package)
    descriptors (package)
    drawing (package)
    formatting (package)
    formula (package)
    packaging (package)
    pivot (package)
    reader (package)
    styles (package)
    utils (package)
    workbook (package)
    worksheet (package)
    writer (package)
    xml (package)

SUBMODULES
    constants

DATA
    DEBUG = False
    DEFUSEDXML = False
    LXML = True
    NUMPY = True
    __author_email__ = 'charlie.clark@clark-consulting.eu'
    __license__ = 'MIT'
    __maintainer_email__ = 'openpyxl-users@googlegroups.com'
    __url__ = 'https://openpyxl.readthedocs.io'

VERSION
    3.1.3

AUTHOR
    See AUTHORS

FILE
    e:\python_workspace\pythonproject\lib\site-packages\openpyxl\__init__.py

3、实战案例

3-201、获取单元格区域内的值，并使其矩阵化

# 3-201、获取单元格区域内的值，并使其矩阵化
from openpyxl import load_workbook
# 加载工作簿
workbook = load_workbook('example.xlsx')
# 选择工作表（例如，第一个工作表）
worksheet = workbook.active  # 或者使用 worksheet = workbook['Sheet1'] 来指定工作表名
# 定义单元格区域（例如，从 A1 到 C3）
start_row, start_col = 1, 1  # A1
end_row, end_col = 3, 3  # C3
# 初始化一个空列表来存储值
values_matrix = []
# 遍历单元格区域
for row in range(start_row, end_row + 1):
    row_values = []
    for col in range(start_col, end_col + 1):
        cell_value = worksheet.cell(row=row, column=col).value
        row_values.append(cell_value)
    values_matrix.append(row_values)
# 现在 values_matrix 是一个二维列表，包含了单元格区域内的所有值
print(values_matrix)

3-202、获取单元格内的前缀字符

# 3-202、获取单元格内的前缀字符
# 导入 openpyxl 库
import openpyxl
# 打开 Excel 文件
wb = openpyxl.load_workbook('example.xlsx')
# 选择目标工作表
ws = wb['Sheet']
# 获取目标单元格的值，例如 A1 单元格
cell_value = ws['A1'].value
# 获取前缀字符（假设你想获取前3个字符）
prefix_length = 3
prefix_chars = cell_value[:prefix_length]
# 打印前缀字符
print(prefix_chars)

3-203、判断单元格内的数字是否为文本字符

# 3-203、判断单元格内的数字是否为文本字符
# 导入 openpyxl 库
import openpyxl
# 打开 Excel 文件
wb = openpyxl.load_workbook('example.xlsx')
# 选择目标工作表
ws = wb['Sheet']
# 遍历工作表所有单元格
for row in ws.iter_rows():
    for cell in row:
        if cell.data_type == 's':
            print(f"单元格 {cell.coordinate} 内容 '{cell.value}' 是文本字符")
        else:
            print(f"单元格 {cell.coordinate} 内容 '{cell.value}' 不是文本字符")

3-204、获取单元格的格式

# 3-204、获取单元格的格式
# 导入openpyxl库
import openpyxl
# 打开Excel文件
wb = openpyxl.load_workbook('example.xlsx')
# 选择目标工作表
ws = wb['Sheet']
# 遍历工作表所有单元格
for row in ws.iter_rows():
    for cell in row:
        cell_format = cell.number_format
        print(f"单元格 {cell.coordinate} 的数字格式为: {cell_format}")

3-205、获取单元格的字体(Font)对象

# 3-205、获取单元格的字体(Font)对象
# 导入openpyxl库
import openpyxl
from openpyxl.styles import Font
# 打开Excel文件
wb = openpyxl.load_workbook('example.xlsx')
# 选择目标工作表
ws = wb['Sheet']
# 获取目标单元格，例如 A1 单元格
cell = ws['A1']
# 获取单元格的字体对象
cell_font = cell.font
# 打印单元格字体相关信息
print(f"单元格 A1 的字体名称为: {cell_font.name}")
print(f"单元格 A1 的字体大小为: {cell_font.size}")
print(f"单元格 A1 的字体颜色为: {cell_font.color}")
print(f"单元格 A1 是否加粗: {cell_font.bold}")
print(f"单元格 A1 是否斜体: {cell_font.italic}")

3-206、获取单元格的内部(Interior)对象

# 3-206、获取单元格的内部(Interior)对象
from openpyxl import load_workbook
from openpyxl.styles import PatternFill
# 加载工作簿
workbook = load_workbook('example.xlsx')
# 选择工作表
worksheet = workbook.active
# 选择一个单元格
cell = worksheet['A1']
# 获取单元格的填充样式
if cell.fill is not None:
    # cell.fill 是一个 PatternFill 对象，它继承了 Interior
    fill = cell.fill
    # 打印填充类型（solid, gradient, etc.）
    print(fill.fill_type)
    # 如果填充类型是 solid，你可以获取前景色
    if fill.fill_type == "solid":
        fgColor = fill.start_color.index  # 这通常是一个 RGB 颜色的索引
        print(fgColor)  # 这可能是一个如 'FF0000' 的十六进制颜色字符串
        # 注意：直接打印 fgColor.rgb 会得到类似 <openpyxl.styles.colors.RGB object> 的结果
        # 要获取 RGB 值，你可能需要访问 fgColor.rgb 的属性（但 openpyxl 可能不直接提供 RGB 值作为字符串）
else:
    print("The cell has no fill style.")
# 注意：openpyxl 的 API 可能会随版本更新而变化
# 总是查阅官方文档以获取最新信息

3-207、获取单元格的边框(Borders)对象

# 3-207、获取单元格的边框(Borders)对象
import openpyxl
from openpyxl.styles import Border, Side
# 打开Excel文件
wb = openpyxl.load_workbook('example.xlsx')
# 选择目标工作表
ws = wb['Sheet']
# 获取目标单元格，例如 A1 单元格
cell = ws['A1']
# 获取单元格的边框对象
cell_border = cell.border
# 打印单元格边框的相关信息示例
print(f"单元格 A1 的左边框样式为: {cell_border.left.border_style}")
print(f"单元格 A1 的左边框颜色为: {cell_border.left.color.rgb if cell_border.left.color else '未设置'}")
print(f"单元格 A1 的上边框样式为: {cell_border.top.border_style} (如果为None则表示未设置)")
# 修改单元格的边框样式示例
thin_border = Side(border_style="thin", color="FF0000")  # 例如，这里将颜色设置为红色
cell.border = Border(left=thin_border, right=thin_border, top=thin_border, bottom=thin_border)
# 保存修改后的Excel文件
wb.save('example_modified.xlsx')  # 最好保存为新的文件名，以防原始文件损坏

3-208、获取单元格边框线的状态

# 3-208、获取单元格边框线的状态
import openpyxl
from openpyxl.styles import Border, Side
# 打开Excel文件
wb = openpyxl.load_workbook('example.xlsx')
# 选择目标工作表
ws = wb['Sheet']
# 获取目标单元格，例如 A1 单元格
cell = ws['A1']
# 获取单元格的边框对象
cell_border = cell.border
# 检查并打印各个边框的状态
print(f"左边框样式: {cell_border.left.border_style if cell_border.left.border_style else '未设置'}")
print(f"右边框样式: {cell_border.right.border_style if cell_border.right.border_style else '未设置'}")
print(f"上边框样式: {cell_border.top.border_style if cell_border.top.border_style else '未设置'}")
print(f"下边框样式: {cell_border.bottom.border_style if cell_border.bottom.border_style else '未设置'}")
# 如果需要，也可以检查边框的颜色
print(f"左边框颜色: {cell_border.left.color.rgb if cell_border.left.color else '未设置'}")
# 注意：如果边框样式为None，颜色属性可能也会是None，即使单元格曾经设置过颜色
# ... 接下来可以执行其他操作 ...
# 关闭工作簿（虽然这通常不是必需的，因为Python的垃圾回收会处理）
# wb.close()

3-209、获取单元格的样式(Style)对象

# 3-209、获取单元格的样式(Style)对象
import openpyxl
from openpyxl.styles import Font, Fill, PatternFill, Border, Side, Alignment
# 打开Excel文件
wb = openpyxl.load_workbook('example.xlsx')
# 选择目标工作表
ws = wb['Sheet']
# 获取目标单元格，例如A1单元格
cell = ws['A1']
# 获取字体样式
font = cell.font
if font:
    print(f"字体名称: {font.name}")
    print(f"字体大小: {font.size}")
    # ... 可以继续检查其他字体属性 ...
# 获取填充样式
fill = cell.fill
if fill and fill.start_color:
    print(f"填充颜色: {fill.start_color.index}")  # 或者使用 fill.fgColor.rgb 来获取RGB值（如果设置了的话）
# 获取边框样式
border = cell.border
if border:
    print(f"左边框样式: {border.left.border_style if border.left.border_style else '未设置'}")
    # ... 可以继续检查其他边框属性 ...
# 获取数字格式
number_format = cell.number_format
print(f"数字格式: {number_format}")
# 获取对齐方式（这也是样式的一部分）
alignment = cell.alignment
if alignment:
    print(f"水平对齐: {alignment.horizontal}")
    print(f"垂直对齐: {alignment.vertical}")
    # ... 可以继续检查其他对齐属性 ...
# ... 接下来可以执行其他操作 ...
# 关闭工作簿（虽然这通常不是必需的，因为Python的垃圾回收会处理）
# wb.close()

3-210、获取单元格的条件格式

略，openpyxl库暂不支持此功能，需要借助其他库实现

3-211、获取单元格的输入规则(有效性设置)

# 3-211、获取单元格的输入规则(有效性设置)
import openpyxl
from openpyxl.worksheet.datavalidation import DataValidation
# 打开Excel文件
wb = openpyxl.load_workbook('example.xlsx')
# 选择目标工作表
ws = wb['Sheet']
# 假设我们要检查的单元格是 A1
target_cell = 'A1'
# 遍历工作表上的所有数据验证规则
for data_val in ws.data_validations.dataValidation:
    # 检查规则是否应用于特定的单元格或单元格范围
    if target_cell in str(data_val.sqref):
        print(f"数据验证规则应用于: {data_val.sqref}")
        print(f"允许的类型: {data_val.type}")
        print(f"允许的公式: {data_val.formula1}（如果适用）")
        print(f"其他公式（例如错误消息）: {data_val.formula2}（如果适用）")
        print(f"显示错误消息: {data_val.showErrorMessage}")
        print(f"显示输入消息: {data_val.showInputMessage}")
        print(f"错误消息标题: {data_val.errorTitle}")
        print(f"错误消息: {data_val.error}")
        print(f"输入消息标题: {data_val.promptTitle}")
        print(f"输入消息: {data_val.prompt}")
        # 其他可能的属性还包括：showDropDownArrow, showErrorBox, allowBlank 等
        # ...
        print()  # 分隔不同规则的输出
# ... 接下来可以执行其他操作 ...
# 关闭工作簿（虽然这通常不是必需的，因为Python的垃圾回收会处理）
# wb.close()

3-212、获取单元格的超链接

# 3-212、获取单元格的超链接
import openpyxl
# 打开 Excel 文件
wb = openpyxl.load_workbook('example.xlsx')
# 选择目标工作表
ws = wb['Sheet']
# 获取单元格D2的超链接
hyperlink = ws.cell(row=2, column=4).hyperlink
# 打印单元格D2的超链接信息
if hyperlink is not None:
    print(f"链接地址: {hyperlink.target}")
    print(f"显示文本: {hyperlink.display}")
# 关闭Excel文件前保存修改
wb.save('example.xlsx')

3-213、获取单元格的批注

# 3-213、获取单元格的批注
import openpyxl
# 打开Excel文件
wb = openpyxl.load_workbook('example.xlsx')
# 选择目标工作表
ws = wb['Sheet1']
# 获取单元格A1的批注
comment = ws.cell(row=1, column=1).comment
# 打印单元格A1的批注信息
if comment:
    print(f"作者: {comment.author}")
    print(f"内容: {comment.text}")
# 关闭Excel文件前保存修改
wb.save('example.xlsx')

3-214、获取单元格的大小(行高和列宽)

# 3-214、获取单元格的大小(行高和列宽)
import openpyxl
# 打开Excel文件
wb = openpyxl.load_workbook('example.xlsx')
# 选择目标工作表
ws = wb.active  # 或者 ws = wb['Sheet1'] 如果你知道具体的sheet名
# 获取列宽
for column, dim in ws.column_dimensions.items():
    print(f"Column {column} has a width of {dim.width} characters (1/256th of the width of the zero character)")
# 获取行高（仅当行高已被设置时）
for row in ws.iter_rows(min_row=1, max_row=ws.max_row):
    for cell in row:
        # 检查row_dimensions中是否有该行的条目
        if ws.row_dimensions.get(cell.row):
            print(f"Row {cell.row} has a height of {ws.row_dimensions[cell.row].height} points")
        else:
            print(f"Row {cell.row} height is not set explicitly")

3-215、获取单元格的坐标

# 3-215、获取单元格的坐标
import openpyxl
# 打开Excel文件
wb = openpyxl.load_workbook('example.xlsx')
# 选择目标工作表
ws = wb.active  # 或者 ws = wb['Sheet1'] 如果你知道具体的sheet名
# 遍历工作表中的所有单元格
for row in ws.iter_rows(min_row=1, max_col=ws.max_column, max_row=ws.max_row, values_only=False):
    for cell in row:
        print(f"单元格的坐标是: ({cell.row}, {cell.column})")

3-216、向单元格输入数值

# 3-216、向单元格输入数值
from openpyxl import Workbook
# 创建一个新的工作簿
wb = Workbook()
# 激活默认的工作表
ws = wb.active
# 选择要写入的单元格，例如 A1
cell = ws['A1']
# 向单元格输入数值
cell.value = 123
# 保存工作簿到文件中
wb.save('example.xlsx')

3-217、向单元格输入字符串

# 3-217、向单元格输入字符串
from openpyxl import Workbook
# 创建一个新的工作簿
wb = Workbook()
# 激活默认的工作表
ws = wb.active
# 选择要写入的单元格，例如 A1
cell = ws['A1']
# 向单元格输入字符串
cell.value = 'Myelsa'
# 保存工作簿到文件中
wb.save('example.xlsx')

3-218、向单元格输入数字字符

# 3-218、向单元格输入数字字符
from openpyxl import Workbook
# 创建一个新的工作簿
wb = Workbook()
# 激活默认的工作表
ws = wb.active
# 选择要写入的单元格，例如 A1
cell = ws['A1']
# 向单元格输入数字字符
cell.value = '168'
# 保存工作簿到文件中
wb.save('example.xlsx')

3-219、向单元格输入日期

# 3-219、向单元格输入日期
from openpyxl import Workbook
from datetime import datetime
# 创建一个新的工作簿
wb = Workbook()
# 激活默认的工作表
ws = wb.active
# 选择要写入的日期单元格，例如 B2
cell = ws['B2']
# 创建一个日期对象
today = datetime.today()
# 向单元格输入日期
cell.value = today
# 保存工作簿到文件中
wb.save('example.xlsx')

3-220、向单元格输入时间

# 3-220、向单元格输入时间
from openpyxl import Workbook
from datetime import datetime
# 创建一个新的工作簿
wb = Workbook()
# 激活默认的工作表
ws = wb.active
# 选择要写入时间的单元格，例如 C3
cell = ws['C3']
# 创建一个时间对象
now = datetime.now()
# 向单元格输入时间
cell.value = now
# 保存工作簿到文件中
wb.save('example.xlsx')