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

目录

一、 openpyxl库的由来

1、背景

2、起源

3、发展

4、特点

4-1、支持.xlsx格式

4-2、读写Excel文件

4-3、操作单元格

4-4、创建和修改工作表

4-5、样式设置

4-6、图表和公式

4-7、支持数字和日期格式

二、openpyxl库的优缺点

1、优点

1-1、支持现代Excel格式

1-2、功能丰富

1-3、易于使用

1-4、与Excel兼容性

1-5、性能良好

1-6、社区支持

1-7、跨平台

2、缺点

2-1、不支持旧版格式

2-2、某些特性支持有限

2-3、内存占用

2-4、文档和示例可能不足

2-5.、依赖关系

2-6、学习曲线

三、openpyxl库的用途

1、读取Excel文件

2、写入Excel文件

3、修改Excel文件

4、自动化

5、与Excel交互

6、数据迁移和转换

7、创建模板化的报告

四、如何学好openpyxl库？

1、获取openpyxl库的属性和方法

2、获取xlwt库的帮助信息

3、用法精讲

3-31、openpyxl.worksheet.worksheet.Worksheet.set_printer_settings函数

3-31-1、语法

3-31-2、参数

3-31-3、功能

3-31-4、返回值

3-31-5、说明

3-31-6、用法

3-32、openpyxl.worksheet.worksheet.Worksheet.unmerge_cells函数

3-32-1、语法

3-32-2、参数

3-32-3、功能

3-32-4、返回值

3-32-5、说明

3-32-6、用法 

3-33、openpyxl.cell.cell.Cell.check_error函数

3-33-1、语法

3-33-2、参数

3-33-3、功能

3-33-4、返回值

3-33-5、说明

3-33-6、用法 

3-34、openpyxl.cell.cell.Cell.check_string函数

3-34-1、语法

3-34-2、参数

3-34-3、功能

3-34-4、返回值

3-34-5、说明

3-34-6、用法

3-35、openpyxl.cell.cell.Cell.offset函数

3-35-1、语法

3-35-2、参数

3-35-3、功能

3-35-4、返回值

3-35-5、说明

3-35-6、用法

五、推荐阅读

1、Python筑基之旅

2、Python函数之旅

3、Python算法之旅

4、Python魔法之旅

5、博客个人主页

一、 openpyxl库的由来

        openpyxl库的由来可以总结为以下几点：

1、背景

        在openpyxl库诞生之前，Python中缺乏一个专门用于读取和编写Office Open XML格式(如Excel 2010及更高版本的.xlsx文件)的库。

2、起源

        openpyxl库的创建是为了解决上述提到的Python在处理Excel文件时的不足，它的开发受到了PHPExcel团队的启发，因为openpyxl最初是基于PHPExcel的。

3、发展

        随着时间的推移，openpyxl逐渐发展成为一个功能强大的Python库，专门用于处理Excel文件。它支持Excel 2010及更高版本的文件格式，并提供了丰富的API，用于读取、写入、修改Excel文件。

4、特点

4-1、支持.xlsx格式

        openpyxl主要用于处理Excel 2010及更新版本的.xlsx文件。

4-2、读写Excel文件

        使用openpyxl可以读取现有的Excel文件，获取数据，修改数据，并保存到新的文件中。

4-3、操作单元格

        openpyxl允许用户按行、列或具体的单元格进行数据的读取和写入。

4-4、创建和修改工作表

        用户可以创建新的工作表，复制和删除现有的工作表，设置工作表的属性等。

4-5、样式设置

        openpyxl支持设置单元格的字体、颜色、边框等样式。

4-6、图表和公式

        用户可以通过openpyxl创建图表、添加公式等。

4-7、支持数字和日期格式

        openpyxl能够正确处理数字和日期格式，确保在Excel中显示正确的格式。

        综上所述，openpyxl库的出现填补了Python在处理Excel文件时的空白，经过不断的发展和完善，成为了一个功能丰富、易于使用的Python库。

二、openpyxl库的优缺点

        openpyxl库是一个用于读写Excel 2010 xlsx/xlsm/xltx/xltm文件的Python库，它基于Python，并且对于处理Excel文件提供了很多便利的功能，其主要优缺点有：

1、优点

1-1、支持现代Excel格式

        openpyxl支持.xlsx格式的Excel文件，这是Excel 2010及更高版本使用的格式，也是目前广泛使用的格式。

1-2、功能丰富

        openpyxl提供了创建、修改和保存Excel工作簿、工作表、单元格、图表、公式、图像等功能。

1-3、易于使用

        openpyxl的API设计得相对直观，使得Python开发者能够很容易地掌握和使用。

1-4、与Excel兼容性

        openpyxl能够处理Excel文件中的很多复杂特性，如公式、样式、条件格式等，这确保了与Excel的良好兼容性。

1-5、性能良好

        在处理大型Excel文件时，openpyxl通常能够保持较好的性能。

1-6、社区支持

        openpyxl是一个开源项目，拥有活跃的社区支持和维护，这意味着开发者可以获得帮助和修复错误的快速响应。

1-7、跨平台

        openpyxl可以在不同的操作系统上运行，包括Windows、Linux和macOS等。

2、缺点

2-1、不支持旧版格式

        openpyxl不支持较旧的.xls格式(Excel 97-2003)。如果需要处理这种格式的文件，需要使用其他库如xlrd和xlwt(尽管这些库也面临一些兼容性和维护问题)。

2-2、某些特性支持有限

        虽然openpyxl支持许多Excel特性，但可能对于某些高级或特定的Excel功能支持有限或不支持。

2-3、内存占用

        在处理大型Excel文件时，openpyxl可能会占用较多的内存。这是因为openpyxl会将整个工作簿加载到内存中。

2-4、文档和示例可能不足

        尽管openpyxl的文档相对完整，但对于某些高级功能或特定用例，可能缺乏足够的示例或详细解释。

2-5.、依赖关系

        openpyxl依赖于lxml和et_xmlfile这两个Python库来处理XML和Excel文件，在某些环境中，可能需要额外安装这些依赖项。

2-6、学习曲线

        虽然openpyxl的API设计得相对直观，但对于初学者来说，可能需要一些时间来熟悉和掌握其用法。

三、openpyxl库的用途

        openpyxl是一个用于读写Excel 2010 xlsx/xlsm/xltx/xltm文件的Python库。它是用Python编写的，不需要Microsoft Excel，并且支持多种Excel数据类型，包括图表、图像、公式等，其主要用途有：

1、读取Excel文件

        你可以使用openpyxl来读取 Excel 文件中的数据，如单元格值、工作表名称、公式等，它支持多种数据类型，如字符串、数字、日期等。

2、写入Excel文件

        使用openpyxl，你可以创建新的Excel文件或向现有文件添加数据，你可以设置单元格的字体、颜色、边框等样式，你还可以添加图表、图像和其他复杂的Excel功能。

3、修改Excel文件

        你可以使用openpyxl来修改现有的Excel文件，如更改单元格值、添加或删除工作表等，这对于自动化数据处理和报告生成非常有用。

4、自动化

        openpyxl可以与其他Python库和框架(如 pandas、numpy、matplotlib 等)结合使用，以自动化数据处理和分析任务。你可以编写脚本来从多个数据源收集数据，将数据整合到 Excel 文件中，并执行各种数据分析任务。

5、与Excel交互

        如果你正在开发需要与Excel交互的应用程序或工具，openpyxl可以提供一个强大的API来处理Excel文件，它允许你读取和写入Excel文件，而无需依赖Microsoft Excel或其他第三方库。

6、数据迁移和转换

        使用openpyxl，你可以轻松地将数据从Excel文件迁移到其他数据库或文件格式，或将其他数据源的数据导入到Excel文件中。

7、创建模板化的报告

        你可以使用openpyxl来创建模板化的Excel报告，并在需要时填充数据，这对于需要定期生成具有一致格式和布局的报告的场景非常有用。

        总之，openpyxl是一个功能强大的库，可用于在Python中处理Excel文件，它提供了灵活的API来读取、写入、修改和自动化Excel文件的各个方面。

四、如何学好openpyxl库？

1、获取openpyxl库的属性和方法

        用print()和dir()两个函数获取openpyxl库所有属性和方法的列表

# ['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、获取xlwt库的帮助信息

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

Help on package openpyxl:NAMEopenpyxl - # Copyright (c) 2010-2024 openpyxlPACKAGE CONTENTS_constantscell (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)SUBMODULESconstantsDATADEBUG = FalseDEFUSEDXML = FalseLXML = TrueNUMPY = True__author_email__ = '[e-mail]'__license__ = 'MIT'__maintainer_email__ = '[e-mail]'__url__ = 'https://openpyxl.readthedocs.io'VERSION3.1.3AUTHORSee AUTHORSFILEe:\python_workspace\pythonproject\lib\site-packages\openpyxl\__init__.py

3、用法精讲

3-31、openpyxl.worksheet.worksheet.Worksheet.set_printer_settings函数

3-31-1、语法

set_printer_settings(self, paper_size, orientation)Set printer settings

3-31-2、参数

3-31-2-1、self(必须)：一个对实例对象本身的引用，在类的所有方法中都会自动传递。

3-31-2-2、paper_size(可选)：指定打印时使用的纸张大小。

3-31-2-3、orientation(可选)：设置打印方向，指定打印时是纵向还是横向。

3-31-3、功能

         设置工作表的打印配置，包括纸张大小、方向、页边距等。

3-31-4、返回值

        没有返回值，它通过直接修改工作表对象的属性来应用打印设置。

3-31-5、说明

        无

3-31-6、用法

# 31、openpyxl.worksheet.worksheet.Worksheet.set_printer_settings函数
from openpyxl import Workbook
from openpyxl.worksheet.page import PageSetup
# 创建一个新的工作簿和工作表
wb = Workbook()
ws = wb.active
# 设置打印设置
ws.set_printer_settings(paper_size=PageSetup.PAPERSIZE_A4, orientation=PageSetup.ORIENTATION_LANDSCAPE)
# 保存工作簿
wb.save("example.xlsx")

3-32、openpyxl.worksheet.worksheet.Worksheet.unmerge_cells函数

3-32-1、语法

unmerge_cells(self, range_string=None, start_row=None, start_column=None, end_row=None, end_column=None)Remove merge on a cell range.  Range is a cell range (e.g. A1:E1)

3-32-2、参数

3-32-2-1、self(必须)：一个对实例对象本身的引用，在类的所有方法中都会自动传递。

3-32-2-2、range_string(可选)：一个字符串，表示要取消合并的单元格范围。例如，"A1:D1" 表示从A1单元格到D1单元格的范围。

3-32-2-3、start_row(可选)：一个整数(默认值为None)，表示要取消合并的起始行索引。

3-32-2-4、start_column(可选)：一个整数(默认值为None)，表示要取消合并的起始列索引。

3-32-2-5、end_row(可选)：一个整数(默认值为None)，表示要取消合并的结束行索引。

3-32-2-6、end_column(可选)：一个整数(默认值为None)，表示要取消合并的结束列索引。

3-32-3、功能

        用于取消工作表中的合并单元格，该函数通过指定合并区域的范围，将该范围内的所有单元格恢复为独立的单元格。

3-32-4、返回值

        没有返回值。它直接对工作表进行操作，取消指定范围内的合并单元格，而不会返回任何数据。

3-32-5、说明

        无

3-32-6、用法 

# 32、openpyxl.worksheet.worksheet.Worksheet.unmerge_cells函数
from openpyxl import Workbook
# 创建一个新的工作簿和工作表
wb = Workbook()
ws = wb.active
# 合并单元格
ws.merge_cells('A1:D1')
# 取消合并单元格
ws.unmerge_cells('A1:D1')  # 没有返回值
# 保存工作簿
wb.save("example.xlsx")

3-33、openpyxl.cell.cell.Cell.check_error函数

3-33-1、语法

check_error(self, value)Tries to convert Error" else N/A

3-33-2、参数

3-33-2-1、self(必须)：一个对实例对象本身的引用，在类的所有方法中都会自动传递。

3-33-2-2、value(必须)：一个字符串或数值，表示需要检查的值。

3-33-3、功能

        用于检测单元格中的内容是否为错误值。

3-33-4、返回值

        返回一个布尔值。如果单元格中的值是错误值，则返回True；反之，则返回False。

3-33-5、说明

3-33-5-1、该方法仅检查传入的值是否为标准的Excel错误值，并不涉及单元格中的公式或其他内容。

3-33-5-2、检查的错误值是固定的，主要包括#DIV/0!、#N/A、#NAME?、#NULL!、#NUM!、#REF!和#VALUE!等。

3-33-6、用法 

# 33、openpyxl.cell.cell.Cell.check_error函数
from openpyxl import Workbook
# 创建一个新的工作簿和工作表
wb = Workbook()
ws = wb.active
# 设置一些单元格值，包括一个错误值
ws['A1'] = 5
ws['A2'] = 0
ws['A3'] = '=A1/A2'  # 这是一个错误值，会导致 #DIV/0!
# 检查单元格A3是否有错误
cell = ws['A3']
has_error = cell.check_error("#DIV/0!")
print(f"Cell A3 has error: {has_error}") # 输出：Cell A3 has error: #DIV/0!
# 保存工作簿
wb.save("example.xlsx")

3-34、openpyxl.cell.cell.Cell.check_string函数

3-34-1、语法

check_string(self, value)Check string coding, length, and line break character

3-34-2、参数

3-34-2-1、self(必须)：一个对实例对象本身的引用，在类的所有方法中都会自动传递。

3-34-2-2、value(必须)：一个字符串，表示需要检查的值。

3-34-3、功能

        用于检查传入的值是否为一个有效的字符串。

3-34-4、返回值

3-34-4-1、如果value是一个有效的字符串，此方法不会返回任何内容。

3-34-4-2、如果value不是一个有效的字符串，此方法会引发TypeError或ValueError异常。

3-34-5、说明

3-34-5-1、此方法仅检查值是否为字符串，并不检查字符串的长度或内容是否符合其他特定要求。

3-34-5-2、如果传入的值不是字符串或包含非法字符，该方法会引发异常，而不是返回一个布尔值。

3-34-6、用法

# 34、openpyxl.cell.cell.Cell.check_string函数
from openpyxl import Workbook
from openpyxl.cell import Cell
# 创建一个新的工作簿和工作表
wb = Workbook()
ws = wb.active
# 创建一个单元格对象
cell = Cell(ws, 'A1')
# 一个有效的字符串值
value = "Hello, OpenPyxl!"
# 检查值是否为有效的字符串
try:cell.check_string(value)print(f"The value '{value}' is a valid string.")
except (TypeError, ValueError) as e:print(f"The value '{value}' is not a valid string: {e}")
# 一个无效的值（例如，包含非法字符或不是字符串）
invalid_value = 12345
try:cell.check_string(invalid_value)print(f"The value '{invalid_value}' is a valid string.")
except (TypeError, ValueError) as e:print(f"The value '{invalid_value}' is not a valid string: {e}")
# 保存工作簿
wb.save("example.xlsx")
# The value 'Hello, OpenPyxl!' is a valid string.
# The value '12345' is not a valid string: decoding to str: need a bytes-like object, int found

3-35、openpyxl.cell.cell.Cell.offset函数

3-35-1、语法

offset(self, row=0, column=0)Returns a cell location relative to this cell.:param row: number of rows to offset:type row: int:param column: number of columns to offset:type column: int:rtype: :class:`openpyxl.cell.Cell`

3-35-2、参数

3-35-2-1、self(必须)：一个对实例对象本身的引用，在类的所有方法中都会自动传递。

3-35-2-2、row(可选)：一个整数类型(默认为 0，即不进行行偏移)，表示指定相对于当前单元格的行偏移量。正值表示向下偏移，负值表示向上偏移。

3-35-2-3、 column(可选)：一个整数类型(默认为 0，即不进行列偏移)，表示指定相对于当前单元格的列偏移量。正值表示向右偏移，负值表示向左偏移。

3-35-3、功能

        用于在 Excel 工作表中相对于当前单元格的位置偏移。

3-35-4、返回值

        返回一个新的Cell对象，表示相对于当前单元格位置的偏移位置的单元格。

3-35-5、说明

        无

3-35-6、用法

# 35、openpyxl.cell.cell.Cell.offset函数
from openpyxl import Workbook
# 创建一个新的工作簿和工作表
wb = Workbook()
ws = wb.active
# 在A1单元格中写入数据
cell = ws['A1']
cell.value = "Hello"
# 偏移函数：获取当前单元格偏移1行2列的位置
offset_cell = cell.offset(row=1, column=2)
# 在偏移位置的单元格中写入数据
offset_cell.value = "World"
# 保存工作簿
wb.save("example.xlsx")

五、推荐阅读

1、Python筑基之旅

2、Python函数之旅

3、Python算法之旅

4、Python魔法之旅

5、博客个人主页