热门文章

最新文章

Python办公自动化之Excel(中)

发布时间:2021-06-11 01:19:31

准备

首先,我们需要安装依赖包

1
2
# 安装依赖包
pip3 install openpyxl

读取数据

使用 openpyxl 中的 load_workbook(filepath) 加载本地一个 Excel 文件,返回结果是一个工作簿对象

1
2
3
4
import openpyxl
 
# 加载本地的Excel文件
wb = openpyxl.load_workbook(file_path)

利用工作簿对象,可以获取所有的 Sheet 名称及 Sheet 列表

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
def get_all_sheet_names(wb):
    """
    获取所有sheet的名称
    :param wb:
    :return:
    """
    # sheet名称列表
    sheet_names = wb.sheetnames
    return sheet_names
  
def get_all_sheet(wb):
    """
    获取所有的sheet
    :param wb:
    :return:
    """
    # sheet名称列表
    sheet_names = get_all_sheet_names(wb)
 
    # 所有sheet
    sheets = []
    for sheet_name in sheet_names:
        sheet = wb[sheet_name]
        sheets.append(sheet)
 
    return sheets

工作簿对象提供了 active 属性,用于快速获取当前选择的 Sheet

1
2
3
4
5
6
7
8
9
10
def get_current_sheet(wb):
    """
    获取当前选择的sheet,默认是最后一个sheet
    :param wb:
    :return:
    """
    # 当前选中的sheet
    current_sheet = wb.active
 
    return current_sheet

另外,也可以通过 Sheet 名称去获取某一个特定的 Sheet 对象

1
2
3
4
5
6
7
8
9
10
11
12
13
def get_sheet_by_name(wb, sheet_name):
    """
    通过sheetname去查找某一个sheet
    :param wb:
    :param sheet_name:
    :return:
    """
    sheet_names = get_all_sheet_names(wb)
    if sheet_name in sheet_names:
        result = wb[sheet_name]
    else:
        result = None
    return result

使用 sheet.max_row 和 sheet.max_column 可以获取当前 Sheet 中的数据行数和列数

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
def get_row_and_column_num(sheet):
    """
    获取sheet的行数和列数
    :param sheet:
    :return:
    """
    # 行数
    row_count = sheet.max_row
    # 列数
    column_count = sheet.max_column
 
    return row_count, column_count
 
# 行数和列数
row_count, column_count = get_row_and_column_num(sheet)
print('行数和列数分别为:', row_count, column_count)

openpyxl 提供 2 种方式来定位一个单元格,分别是:

  • 数字索引,从 1 开始

数字索引:行数字索引、列数字索引

比如:row_index=1,column_index=1

  • 行和列组成的字符串索引

字符串索引:列由字母组成 + 行索引

比如:A1 对应第一行、第一列的单元格

并且,openpyxl.utils 提供了方法,便于 列索引 在两者之间进行转换

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
from openpyxl.utils import get_column_letter, column_index_from_string
 
def column_num_to_str(num):
    """
    Excel索引列从数字转为字母
    :param num:
    :return:
    """
    return get_column_letter(num)
  
def column_str_to_num(str):
    """
    Excel索引列,从字母转为数字
    :param str:
    :return:
    """
    return column_index_from_string(str)

单元格的获取,同样可以通过上面 2 种索引方式来获取

1
2
3
4
5
6
7
8
9
10
11
12
13
14
def get_cell(sheet, row_index, column_index):
    """
    获取单元格
    :param sheet:
    :param row_index:
    :param column_index:
    :return:
    """
    # openpyxl索引都是从1开始计数,这与xlrd有所不同
    # 获取某一个单元格(二选一)
    # 比如:获取A1单元格的数据,即第一个行、第一列的数据
    # cell_one = sheet['A1']
    cell_one = sheet.cell(row=row_index, column=column_index)
    return cell_one

在日常处理 Excel 数据过程中,可能需要判断单元格数据类型,而 openpyxl 并没有提供现成的方法

这里,我们可以通过单元格对象的 value 属性拿到值,接着使用 isinstance 方法判断数据类型

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
def get_cell_value_and_type(cell):
    """
    获取某一个cell的内容及数据类型
    :param cell:
    :return:
    """
    # 单元格的值
    cell_value = cell.value
    # 单元格的类型
    cell_type = get_cell_value_type(cell_value)
 
    return cell_value, cell_type
 
def get_cell_value_type(cell_value):
    """
    获取数据类型
    :param cell_value:
    :return:
    """
    # 其中
    # 0:空
    # 1:数字
    # 2:字符串
    # 3:日期
    # 4:其他
    if not cell_value:
        cell_type = 0
    elif isinstance(cell_value, int) or isinstance(cell_value, float):
        cell_type = 1
    elif isinstance(cell_value, str):
        cell_type = 2
    elif isinstance(cell_value, datetime.datetime):
        cell_type = 3
    else:
        cell_type = 4
    return cell_type

单独获取某一行[列]的数据,可以使用下面的方式:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
def get_row_cells_by_index(sheet, row_index):
    """
    通过行索引,获取某一行的单元格
    :param row_index:
    :return:
    """
    # 注意:第一列从1开始
    row_cells = sheet[row_index]
    return row_cells
  
def get_column_cells_by_index(sheet, column_index):
    """
    通过列索引,获取某一列的单元格
    """
    # 数字转为字母
    column_index_str = column_num_to_str(column_index)
    # 获取某一列的数据
    column_cells = sheet[column_index_str]
    return column_cells

需要注意的是,获取某一行的数据需要传入数字索引;而对于列数据的获取,必须传入字符串索引

和 Python 列表范围取值类似,openpyxl 同样支持使用 : 符号拿到某个范围内的数据行[列]

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
def get_rows_by_range(sheet, row_index_start, row_index_end):
    """
    通过范围去选择行范围
    比如:选择第2行到第4行的所有数据,返回值为元组
    :param sheet:
    :param row_index_start:
    :param row_index_end:
    :return:
    """
    rows_range = sheet[row_index_start:row_index_end]
    return rows_range
  
def get_columns_by_range(sheet, column_index_start, column_index_end):
    """
    通过范围去选择列范围
    比如:选择第2列到第4列的所有数据,返回值为元组
    :param sheet:
    :param column_index_start:
    :param column_index_end:
    :return:
    """
    columns_range = sheet[column_num_to_str(column_index_start):column_num_to_str(column_index_end)]
    return columns_range

写入数据

要写入数据到 Excel 表格

首先,使用 openpyxl.Workbook() 创建一个 Excel 工作簿对象

接着,使用工作簿对象的 create_sheet() 新建一个 Sheet

1
2
3
4
5
6
7
8
9
# 创建一个Excel工作簿
# 注意:每次新建一个Excel文件,都会默认生成一个名称为【Sheet】的工作表Sheet
wb = openpyxl.Workbook()
 
# 创建一个新的sheet,默认被插到尾部
# new_sheet = wb.create_sheet('新的Sheet')
# 也可以通过第二个参数:index来指定插入的位置
# 比如:插入到开头
new_sheet = wb.create_sheet('新的Sheet', 0)

默认创建的 Sheet 被插入到最后一个位置,第 2 个参数可以指定 Sheet 插入的位置

Sheet 标签的背景色同样支持修改,使用 sheet_properties.tabColor 指定 RGB 颜色值

比如,要设置某一个 Sheet 的背景色为红色,只需要先查询到对应的 Sheet,然后指定颜色值为 FF0000 即可

1
2
3
4
5
6
7
8
9
10
11
def set_sheet_bg_color(sheet, rgb_value):
    """
    设置Sheet标签的颜色
    :param rgb_value:
    :return:
    """
    # 设置Sheet底部按钮的颜色(RRGGBB)
    sheet.sheet_properties.tabColor = rgb_value
 
 # 设置Sheet的背景色(红色)
set_sheet_bg_color(new_sheet, 'FF0000')

openpyxl 支持行列数字索引、字符串索引以这 2 种方式写入数据到单元格中

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
def write_value_to_cell_with_num(sheet, row_index, column_index, value):
    """
    按行索引、列索引写入数据
    :param shell:
    :param row_index: 行索引
    :param column_index: 列索引
    :param value:
    :return:
    """
    # 二选一
    sheet.cell(row=row_index, column=column_index, value=value)
    # shell.cell(row=row_index, column=column_index).value = value
  
def write_value_to_cell_with_index_str(sheet, index_str, value):
    """
    按字母位置,写入数据到对应单元格
    :param shell:
    :param index_str: 字母对应的单元格位置
    :param value:
    :return:
    """
    sheet[index_str] = value

在单元格中插入图片也很简单,openpyxl 提供的 add_image() 方法

参数有 2 个,分别是:图片对象、单元格字符串索引

为了便于使用,我们可以将列索引进行转换,然后封装成两个插入图片的方法

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
from openpyxl.drawing.image import Image
 
def insert_img_to_cell_with_num(sheet, image_path, row_index, column_index):
    """
    往单元格中插入图片
    :param sheet:
    :param image_path:
    :param row_index:
    :param column_index:
    :return:
    """
    # 通过行索引、列索引,获取到字母索引
    index_str = column_num_to_str(column_index) + str(row_index)
    insert_img_to_cell_with_str(sheet, image_path, index_str)
 
def insert_img_to_cell_with_str(sheet, image_path, index_str):
    """
    往单元格中插入图片
    :param sheet:
    :param image_path:
    :param index_str:
    :return:
    """
    sheet.add_image((image_path), index_str)

最后,调用工作簿对象的 save() 方法,将数据真实写入到 Excel 文件中

1
2
3
# 注意:必须要写入,才能真实的保存到文件中
wb.template = False