Python模块之XlsxWriter
数据报表之Excel操作模块
一、介绍
利用Python操作Excel的模块XlsxWriter,可以操作多个工作表的文字,数字,公式,图表等。此模板只能新建,添加数据,而不能编辑已知数据。
XlsxWriter模块支持的功能:
- 100%兼容的Excel XLSX文件,支持Excel2003、Excel2007等版本
- 支持所有Excel单元格数据格式
- 单元格合并、批注、自动筛选、丰富多格式字符串等
- 支持工作表PNG、JPEG图像,自定义图表
- 内存优化模式支持写入大文件
二、安装
pip install XlsxWriter #pip安装方法
三、模块常用方法说明
1.Workbook类
语法:Workbook([filename[,options])
Workbook类代表整个电子表格文件,并且存储在磁盘上。
参数解析:
filename(String类型)为创建Excel文件存储路径
option(Dict类型)为可选的Workbook参数,一般作为初始化工作表内容格式,例如{'strings_to_numbers':True}表示使用worksheet.write()方法时激活字符串转换数字
- add_worksheet([sheetname])方法
作用:添加一个新的工作表
参数解析:sheetname(String类型)为可选的工作表名称,默认为Sheet1
worksheet1 = workbook.add_worksheet() #Sheet1
worksheet2 = workbook.add_worksheet("表1") #表1
worksheet2 = workbook.add_worksheet() #sheet3
- add_format([properties])方法
作用:在工作表中创建一个新的饿格式对象来格式化单元格
参数解析:properties(dict类型)为指定一个格式属性的字典
例如:设置加粗格式对象,workbook.add_format({"blod":True})
通过Format methods(格式化方法)也可实现与字体加粗效果
bold = workbook.add_format({"bold":True}) #方法一
bold2 = workbook.add_format()
bold2.set_bold() #方法二
- add_chart(option)方法
作用:工作表中创建一个图表对象,内部是通过insert_chart()方法来实现
参数解析:options(dict类型)为图表指定一个字典属性
例如:设置一个线条类型的图标对象,workbook.add_chart({"type":"line"})
chart = workbook.add_chart({"type":"line"})
- close() 方法
作用:关闭工作表文件
workbook.close()
2.Worksheet类
代表一个Excel工作表,不能直接实例化,需要通过Workbook对象调用add_worksheet()方法来创建
worksheet = xlsxwriter.Workbook('test.xlsx').add_worksheet() #创建Sheet1工作表对象
- *write(row , col , args)方法
作用:写普通数据到工作表的单元格
参数解析:参数row为行坐标;col为列坐标;坐标索引起始值为0;*args为数据内容,可以为数字、公式、字符串或格式对象
write方法已经作为其他更加具体数据类型方法的别名,包括:
-
- write_string() 写入字符串类型数据,如
worksheet.write_string(0,0,"Your text here")
-
- write_number() 写入数字类型数据,如
worksheet.write_number('A2',2.345)
-
- write_blank() 写入空类型数据,如
worksheet.write("A2",None)
-
- write_formula() 写入公式类型数据,如
worksheet.write_formula(2,0,"=SUM(B1:B5)")
-
- write_datetime() 写入日期类型数据,如
import datetime
worksheet.write_datetime(7 , 0 , datetime.datetime.strptime('2018-07-31','%Y-%m-%d'),workbook.add_format({'num_format':'yyyy-m-dd'}))
-
- write_boolean() 写入逻辑类型数据,如
worksheet.write_boolean(0 , 0 , True)
-
- write_url() 写入超链接类型数据,如
worksheet.write_url("A1","ftp://www.python.org/")
write方法与别名对应关系
worksheet.write(0 , 0 , 'hello') #对应write_string()
worksheet.write(1, 0 , 3.002) #write_number()
worksheet.write(2 , 0 , '=SUM(A1:A2)') #write_formula()
worksheet.write(3 , 0 , '') #write_blank()
worksheet.write(4, 0 , None) #write_blank()
- set_row(row , height , cell_format , options)方法
作用:设置行单元格的属性
参数解析:row(int类型)行位置,起始下标为0;height(float类型)行高,单位像素;cell_format(format类型)指定格式对象;options(dict类型)设置行hidden(隐藏)、level(组合分级)、collapsed(折叠)
worksheet.write("A1","hello") #在A1单元格写入"hello"字符串
cell_format = workbook.add_format({"bold":True}) #定义一个加粗的格式对象
worksheet.set_row(0 , 40 , cell_format) #设置第1行单元格高度40像素,且引用加粗格式对象
worksheet.set_row(1,None,None,{"hidden":True}) #隐藏第2行单元格
-
set_column(first_col , last_col , width , cell_format , options) 方法
作用:设置一列或多列单元格属性
参数解析:first_col(int类型),开始列位置,起始下标0;last_col(int类型)结束列位置,起始下标为0;width(float类型)设置列宽;cell_format(Format类型)格式对象;options(dict类型)行hidden(隐藏)、level(组合分级)、collapse(折叠)
worksheet.write('A1' , 'hello') #在A1单元格写入"hello"字符串
worksheet.write('B1',"world") #在B1单元格写入“world”字符串
cell_format = workbook.add_format({"bold":True}) #定义一个加粗的格式对象
worksheet.set_column(0 , 1 , 10 , cell_format) #设置0到1列单元格宽度为10像素,且引用加粗格式对象
worksheet.set_column("C:D", 20) #设置C到D列单元格宽度20像素
worksheet.set_column("E:G" , None , None , {"hidden":1}) #隐藏E到G列单元格
- insert_image(row , col , image[, options])方法
作用:插入图片到指定单元格,支持PNG、JPEG、BMP等图片格式
参数解析:row(int类型)行坐标;col(int类型)列坐标;坐标索引值为0;image(string类型)图片路径;options(dict类型)可选参数,指定图片的位置、比例、链接URL等信息
#在B5单元格插入python-logo.png图片,图片超链接http://python.org
worksheet.insert_image("B5",'img/python-logo.png',{'url':'http://python.org'})
3.Chart类
语句:chart = xlswriter.Workbook("a.xlsx").add_chart({type,'图表类型'})
支持图标类型包括面积、条形图、柱形图、折线图、饼图、散点图、股票和雷达等
图表类型:
- area:创建一个面积样式的图表
- bar:创建一个条形样式图表
- column:创建一个柱形样式的图表
- line:创建一个线条样式的图表
- pie:创建一个饼图样式的图表
- scatter:创建一个散点样式的图表
- stock:创建一个股票样式的图表
- radar:创建一个雷达样式的图表
chart = xlswriter.Workbook("a.xlsx").add_chart({type,'column'})
worksheet.insert_chart('A7',chart) #在A7单元格插入图表
- char.add_series(options)方法
作用:添加一个数据系列到图表
参数解析:options(dict类型)设置图表系列选项的字典
char.add_series({
'categories':'=Sheet1!$A$1:$A$5', #categories指图表类型标签范围
'values':"=Sheet1!$B$1:$B$5", #values设置图表数据范围
'line':{'color':'red'}, #line设置图表线条属性,包括颜色,宽度等
})
- set_x_axis(options)方法
作用:设置图表X轴选项
chart.set_x_axis({
'name':'月销售额', #设置x轴标题名称
'name_font':{'size':14,'bold':True}, #设置X轴标题字体属性
"num_font":{'italic':True}, #设置x轴数字字体属性
})
- set_size(options)方法
作用:设置图表大小
chart.set_size({"width":720,"height":576}) #width为宽度,height为高度
- set_title(options)方法
作用:设置图表标题
chart.set_titile({"name":"每月销售统计"})
- set_style(style_id)方法
作用:设置图表样式
参数解析:style_id为不同数字则代表不同样式
chart.set_style(37) #37代表37样式
- set_table(options)方法
作用:设置X轴为数据表格形式
chart.set_table()
四、简单案例
import xlsxwriter
workbook = xlsxwriter.Workbook("demo1.xlsx") #创建一个Excel文件
bold = workbook.add_format({"bold":True}) #定义一个加粗的格式对象
worksheet.set_column('A:A',20) #设定第一列(A)宽度为20像素
bold = workbook.add_format({"bold":True}) #定义一个加粗的格式对象
worksheet.write('A1','hello')
worksheet.write('A2','World',bold) #A2单元格写入"World"并引用加粗格式对象bold
worksheet.write('B2',u'中文测试',bold) #B2单元格写入中文并引用加粗格式对象bold
worksheet.write(2,0,32) #第2行,第0列,填入数字32
worksheet.write(3,0,35.5) #第3行,第0 列,填入数字35.5
worksheet.write(4,0,'=SUM(A3:A4)') #在第4行,第0列,计算A3:A4的和
worksheet.insert_image('B5','img/书.jpg') #在B5位置插入图片
workbook.close() #关闭Excel文件,同时意味着保存数据