Xlsx是python用来构造xlsx文件的模块,可以向excel2007+中写text,numbers,formulas 公式以及hyperlinks超链接。

可以完成xlsx文件的自动化构造,包括:

合并单元格,制作excel图表等功能:

import xlsxwriter


# Create an new Excel file and add a worksheet.  
workbook = xlsxwriter.Workbook('demo.xlsx')     #创建工作簿
worksheet = workbook.add_worksheet()            #创建工作表

# Widen the first column to make the text clearer. 
worksheet.set_column('A:A', 20)       #设置一列或者多列单元属性

# Add a bold format to use to highlight cells.
bold = workbook.add_format({'bold': True})    #在工作表中创建一个新的格式对象来格式化单元格,实现加粗

# Write some simple text.
worksheet.write('A1', 'Hello')       #工总表写入简单文本

# Text with formatting.
worksheet.write('A2', 'World', bold)     #工作表写入带有格式的文本,加粗

# Write some numbers, with row/column notation.  #按照坐标写入
worksheet.write(2, 0, 123)     
worksheet.write(3, 0, 123.456)

# Insert an image.
worksheet.insert_image('B5', 'logo.png')   #插入图片

workbook.close()    #关闭工作薄

方法详细解释:

1.workbook类


定义:Workbook(filename[,options])

该类创建一个XlsxWriter的Workbook对象。Workbook代表整个电子表格文件,并且存储在磁盘上。filename为字符串类型,表示创建的excel文件存储路径;

options:为dict类型,是可选参数,一般作为初始化工作表内容格式

add_worksheet

add_worksheet([sheetname])方法,用于添加一个新的工作表,sheetname为工作表名称,默认是sheet1,例如:

    worksheet1 = workbook.add_worksheet()   #sheet1
    worksheet2 = workbook.add_worksheet('test')     #test
    worksheet3 = workbook.add_worksheet('data')     #data
    worksheet4 = workbook.add_worksheet()   #sheet4

add_format

add_format([properties])方法,用于在工作表中创建一个新的格式对象来格式化单元格

properties:为dict类型,为指定一个格式属性的字典

例如设置一个加粗的格式对象如下:

    bold = workbook.add_format({'bold': True})
    等价的语句如下:
    bold = workbook.add_format()
    bold.set_bold()

add_chart

add_chart(options)方法,用于在工作表中创建一个图表对象,内部是通过insert_chart()方法来实现的,参数为dict类型,是为图标指定一个字典属性。

例如设置一个线条行的图表对象,代码如下:

  chart = workbook.add_chart({'type': 'line'})1

close

close()方法,作用是关闭工作表文件,如:

workbook.close()


2.Worksheet类

代表一个excel工作表,是比较核心的一个类。Worksheet对象不能直接实例化,而是通过Workbook对象调用add_worksheet()方法来创建,常见的方法如下:

write

write(row, col, *args)方法:是用来将普通数据写入单元格中。

row:行坐标;
col:列坐标; 坐标索引起始值为0
*args:无名字参数为数据内容,可为数字,公式,字符串或格式对象

为了简化不同数据类型的写入过程,write方法已作为其他更加具体的数据类型方法的别名,如:

  write.string():写入字符串类型数据 
  wirte_number():写入数字型数据 
  write_blank():写入空类型数据  
 write_formula():写入公式型数据 
 write_datetime():写入日期型数据  
 wirte_boolean():写入逻辑型数据  
 write_url():写入超链接型数据


set_row

set_row(row, height, cell_format, options)方法,用于设定行单元格的属性。

row:指定行位置,起始下标为0;
height:为float类型,设定行高,单位像素;
cell_format:format类型,指定对象格式;
options,字典类型,设置行hidden(隐藏)、level(组合分级)、collpsed(折叠)

示例如下:

  worksheet2.write('A1', 'hello')
  bold = workbook.add_format({'bold': True})  # 设定A1行高40,加粗
  worksheet2.set_row(0, 40, bold)  # 隐藏第二行
  worksheet2.set_row(1, None, None, {'hidden': True})

set_column

set_column(first_col, last_col, width, cell_format, options)方法,用于设置一列或多列单元格的属性

first_col:整型,指定开始列位置,起始下标为0;
last_col:整型,指定结束列位置,起始下标为0;
width:float类型,设置列宽;
cell_format:format类型,指定格式对象;
options:dict类型,设置hidden(隐藏)、level(组合分级)、collpsed(折叠);


示例如下:

  worksheet2.write('A1', 'hello')
  worksheet2.write('B1', 'world')
  bold = workbook.add_format({'bold': True})  # 设定列A到B单元格宽度10像素,加粗
  worksheet2.set_column(0, 1, 10, bold)  # 设置C到D单元格宽度20像素
  worksheet2.set_column('C:D', 20)
  隐藏E到G单元格
  worksheet2.set_column('E:G', None, None, {'hidden': 1})

insert_image

insert_image(row, col, image[, options])方法,用于插入图片到指定的单元格,支持PNG,JPEG,BMP等多种格式。

row:行坐标,起始索引值为0;
col:列坐标,起始索引值为0;
image:string类型,是图片路径;
options:dict类型,是可选参数,用于指定图片位置,如URL等信息;

示例如下:

  # 在B5单元格插入python-logo.png图片,超链接为http://python.org
  worksheet1.insert_image('B5', 'img/python-logo.png', {'url': 'http://python.org'})12

chart类

chart类实图表组件,支持包括面积、条形图、柱状图、折线图、散点图等,一个图表对象是通过Workbook的add_chart方法创建,通过{type, ‘图表类型’}字典来制定图表类型,示例如下:

  # 创建一个column(柱形)图表
  chart = workbook.add_chart({type, 'column'})12

常见的图表样式如下:

area:面积样式的图表
bar:条形图
column:柱状图
line:线条样式的图表
pie:饼形图
scatter:散点图
stock:股票样式的图表
radar:雷达样式的图表

然后通过Worksheet的insert_chart()方法插入到指定位置,示例如下:

几个常用方法如下:

add_series

chart.add_series(options)方法:用于添加一个数据系列的图表,参数options为字典类型,用于设置图表系列选项的字典,示例如下:

  chart.add_series({
      'categories': '=Sheet1!$A$1:$A$5',
      'values': '=Sheet1!$B$1:$B$5',
      'line': {'color': 'red'},
  })12345

add_series的常用三个选项:

categories:设置图表类别标签范围;
values:设置图表数据范围;
line:设置图表线条属性,包括宽度、颜色等;

set_x_axis

set_x_axis(options)方法,设置图表X轴选项,示例如下:

 chart.set_x_axis({      'name': 'x name',      'name_font': {'size': 14, 'bold': True}      'num_font': {'italic': True}
  })12345
  
  name:设置x轴名称;
name_font:设置x轴字体;
num_font:设置x轴数字字体属性;

set_size

set_size(options)方法,用于设置图表大小,示例如下:

  chart.set_size({'width': 720, 'height': 576})1
width:设置宽度;
height:设置高度;

set_title

set_title(options)方法,设置图表标题,示例如下:

chart.set_title({'name': 'test'})1

set_style

set_style(style_id)方法,用于设置图表样式,style_id为不同数字代表不同样式,示例如下:

  chart.set_style(37)1

set_table

set_table(options)方法,设置x轴为数据表格式。示例如下:

  chart.set_table()