Python模塊之XlsxWriter

數據報表之Excel操作模塊

目錄

• 數據報表之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文件，同時意味着保存數據