openpyxl3.0官方文檔(1)——入門(mén)教程

創(chuàng)建工作簿?

在使用openpyxl庫(kù)時(shí)疏尿,無(wú)需創(chuàng)建一個(gè)空白的Excel文件榆鼠。只需要導(dǎo)入Workbook類(lèi):

    >>> from openpyxl import Workbook
    >>> wb = Workbook()

在Excel工作簿中至少包含一個(gè)工作表震鹉【愕眩可以通過(guò)Workbook.active屬性來(lái)獲取當(dāng)前活動(dòng)工作表:

    >>> ws = wb.active

active屬性默認(rèn)為0。在未重新賦值情況下传趾,可以使用此方法獲得第一個(gè)工作表迎膜。
可以使用Workbook.create_sheet()方法來(lái)創(chuàng)建新的工作表:

    >>> ws1 = wb.create_sheet("Mysheet") # insert at the end (default)
    # or
    >>> ws2 = wb.create_sheet("Mysheet", 0) # insert at first position
    # or
    >>> ws3 = wb.create_sheet("Mysheet", -1) # insert at the penultimate position

如果新建表名相同,在創(chuàng)建時(shí)將自動(dòng)按數(shù)字命名浆兰,例如Sheet, Sheet1, Sheet2磕仅。可以在任何時(shí)刻通過(guò)Worksheet.title屬性來(lái)修改名稱:

    ws.title = "New Title"

包含此標(biāo)題的工作表標(biāo)簽的默認(rèn)背景顏色為白色簸呈¢哦可以將新的RRGGBB值賦值給Worksheet.sheet_properties.tabColor屬性來(lái)修改顏色:

    ws.sheet_properties.tabColor = "1072BA"

在給工作表命名后,你就可以使用該名字作為工作簿的一個(gè)鍵來(lái)獲取工作表:

    >>> ws3 = wb["New Title"]

可以通過(guò)Workbook.sheetname屬性來(lái)獲取所有的工作表名稱:

    >>> print(wb.sheetnames)
    ['Sheet2', 'New Title', 'Sheet1']

您可以使用for循環(huán)遍歷所有的工作表:

    >>> for sheet in wb:
    ...     print(sheet.title)

可以使用Workbook.copy_worksheet()方法在同一個(gè)工作簿中創(chuàng)建工作表的副本:

    >>> source = wb.active
    >>> target = wb.copy_worksheet(source)

只有單元格(包括值蜕便、樣式劫恒、超鏈接和注釋)和某些工作表屬性(包括維度、格式和屬性)被復(fù)制轿腺。所有其他工作簿/工作表屬性不被復(fù)制两嘴,例如圖像、圖表族壳。
您也不能在工作簿之間復(fù)制工作表憔辫。如果工作簿是打開(kāi)的、只讀的或只寫(xiě)的仿荆,也不能復(fù)制工作表贰您。

處理數(shù)據(jù)?

訪問(wèn)一個(gè)單元格?

現(xiàn)在我們知道如何獲得工作表喧务,我們可以開(kāi)始修改單元格內(nèi)容⊥髌裕可以把單元格位置作為工作表的鍵直接訪問(wèn):

    >>> c = ws['A4']

這將返回A4位置的單元格。如果不存在將創(chuàng)建單元格A4庐冯∧跚祝可以直接為單元格賦值:

    >>> ws['A4'] = 4

Worksheet.cell()方法可實(shí)現(xiàn)相同作用,該方法使用行和列值參數(shù)來(lái)訪問(wèn)單元格:

    >>> d = ws.cell(row=4, column=2, value=10)

注解
在內(nèi)存中創(chuàng)建工作表時(shí)展父,它不包含“單元格”返劲。它們是第一次訪問(wèn)時(shí)創(chuàng)建的。
警告
由于這個(gè)特性栖茉,滾動(dòng)單元格而不是直接訪問(wèn)單元格將在內(nèi)存中創(chuàng)建所有單元格篮绿,即使您沒(méi)有給它們賦值。
比如:

    >>> for x in range(1,101):
    ...        for y in range(1,101):
    ...            ws.cell(row=x, column=y)

將在內(nèi)存中創(chuàng)建100x100個(gè)單元格吕漂。

訪問(wèn)多個(gè)單元格?

可以使用切片訪問(wèn)單元格區(qū)域:

    >>> cell_range = ws['A1':'C2']

可以單獨(dú)指定行或列的范圍:

    >>> colC = ws['C']
    >>> col_range = ws['C:D']
    >>> row10 = ws[10]
    >>> row_range = ws[5:10]

您也可以使用Worksheet.iter_rows()方法:

    >>> for row in ws.iter_rows(min_row=1, max_col=3, max_row=2):
    ...    for cell in row:
    ...        print(cell)
    <Cell Sheet1.A1>
    <Cell Sheet1.B1>
    <Cell Sheet1.C1>
    <Cell Sheet1.A2>
    <Cell Sheet1.B2>
    <Cell Sheet1.C2>

同樣的Worksheet.iter_cols()方法將返回列:

    >>> for col in ws.iter_cols(min_row=1, max_col=3, max_row=2):
    ...     for cell in col:
    ...         print(cell)
    <Cell Sheet1.A1>
    <Cell Sheet1.A2>
    <Cell Sheet1.B1>
    <Cell Sheet1.B2>
    <Cell Sheet1.C1>
    <Cell Sheet1.C2>

注解
出于性能原因亲配,Worksheet.iter_cols()方法在只讀模式下不可用。
如果需要遍歷文件的所有行或列惶凝,可以使用Worksheet.rows屬性:

    >>> ws = wb.active
    >>> ws['C9'] = 'hello world'
    >>> tuple(ws.rows)
    ((<Cell Sheet.A1>, <Cell Sheet.B1>, <Cell Sheet.C1>),
    (<Cell Sheet.A2>, <Cell Sheet.B2>, <Cell Sheet.C2>),
    (<Cell Sheet.A3>, <Cell Sheet.B3>, <Cell Sheet.C3>),
    (<Cell Sheet.A4>, <Cell Sheet.B4>, <Cell Sheet.C4>),
    (<Cell Sheet.A5>, <Cell Sheet.B5>, <Cell Sheet.C5>),
    (<Cell Sheet.A6>, <Cell Sheet.B6>, <Cell Sheet.C6>),
    (<Cell Sheet.A7>, <Cell Sheet.B7>, <Cell Sheet.C7>),
    (<Cell Sheet.A8>, <Cell Sheet.B8>, <Cell Sheet.C8>),
    (<Cell Sheet.A9>, <Cell Sheet.B9>, <Cell Sheet.C9>))

Worksheet.columns屬性:

    >>> tuple(ws.columns)
    ((<Cell Sheet.A1>,
    <Cell Sheet.A2>,
    <Cell Sheet.A3>,
    <Cell Sheet.A4>,
    <Cell Sheet.A5>,
    <Cell Sheet.A6>,
    ...
    <Cell Sheet.B7>,
    <Cell Sheet.B8>,
    <Cell Sheet.B9>),
    (<Cell Sheet.C1>,
    <Cell Sheet.C2>,
    <Cell Sheet.C3>,
    <Cell Sheet.C4>,
    <Cell Sheet.C5>,
    <Cell Sheet.C6>,
    <Cell Sheet.C7>,
    <Cell Sheet.C8>,
    <Cell Sheet.C9>))

注解
出于性能原因吼虎,Worksheet.columns屬性在只讀模式下不可用。

只包括數(shù)值?

如果只需要工作表中的值苍鲜,可以使用對(duì)象:obj:Worksheet.values屬性思灰。這將遍歷工作表中的所有行,但只返回單元格值:

    for row in ws.values:
       for value in row:
         print(value)

兩者Worksheet.iter_rows()Worksheet.iter_cols()可以設(shè)置values_only參數(shù)來(lái)僅返回單元格的值:

    >>> for row in ws.iter_rows(min_row=1, max_col=3, max_row=2, values_only=True):
    ...   print(row)
    (None, None, None)
    (None, None, None)

數(shù)據(jù)存儲(chǔ)?

當(dāng)我們有一個(gè)單元格類(lèi)Cell對(duì)象混滔,我們就可以給它賦值:

    >>> c.value = 'hello, world'
    >>> print(c.value)
    'hello, world'
    >>> d.value = 3.14
    >>> print(d.value)
    3.14

保存到文件?

保存工作簿最簡(jiǎn)單洒疚、最安全的方法是使用函數(shù)Workbook.save()

    >>> wb = Workbook()
    >>> wb.save('balances.xlsx')

警告
此操作將覆蓋現(xiàn)有文件而不發(fā)出警告。
注解
文件擴(kuò)展名不必是xlsx或xlsm坯屿,但如果不使用正式擴(kuò)展名油湖,則可能在使用其他應(yīng)用程序直接打開(kāi)文件時(shí)遇到一些問(wèn)題。
由于OOXML文件基本上是ZIP文件领跛,因此您還可以使用您喜愛(ài)的ZIP壓縮文檔管理器打開(kāi)它肺魁。

保存為流?

如果要將文件保存到流中,例如在使用網(wǎng)絡(luò)應(yīng)用程序(如Pyramid隔节、Flask或Django)鹅经,則只需提供NamedTemporaryFile()

    >>> from tempfile import NamedTemporaryFile
    >>> from openpyxl import Workbook
    >>> wb = Workbook()
    >>> with NamedTemporaryFile() as tmp:
            wb.save(tmp.name)
            tmp.seek(0)
            stream = tmp.read()

可以指定template=True屬性,將工作簿保存為模板:

    >>> wb = load_workbook('document.xlsx')
    >>> wb.template = True
    >>> wb.save('document_template.xltx')

或?qū)⒋藢傩栽O(shè)置為“False”(默認(rèn)值)怎诫,以另存為文檔:

    >>> wb = load_workbook('document_template.xltx')
    >>> wb.template = False
    >>> wb.save('document.xlsx', as_template=False)

警告
在在文檔模板中保存文檔時(shí)您應(yīng)該關(guān)注數(shù)據(jù)屬性和文檔擴(kuò)展是否正確瘾晃,反之亦然。否則無(wú)法打開(kāi)文檔幻妓。
注解
以下操作將失敱奈蟆:

    >>> wb = load_workbook('document.xlsx')
    >>> # Need to save with the extension *.xlsx
    >>> wb.save('new_document.xlsm')
    >>> # MS Excel can't open the document
    >>>
    >>> # or
    >>>
    >>> # Need specify attribute keep_vba=True
    >>> wb = load_workbook('document.xlsm')
    >>> wb.save('new_document.xlsm')
    >>> # MS Excel will not open the document
    >>>
    >>> # or
    >>>
    >>> wb = load_workbook('document.xltm', keep_vba=True)
    >>> # If we need a template document, then we must specify extension as *.xltm.
    >>> wb.save('new_document.xlsm')
    >>> # MS Excel will not open the document

從文件加載?

和寫(xiě)入Excel文件類(lèi)似劫拢,您可以使用openpyxl.load_workbook()方法打開(kāi)現(xiàn)有工作簿:

    >>> from openpyxl import load_workbook
    >>> wb2 = load_workbook('test.xlsx')
    >>> print wb2.sheetnames
    ['Sheet2', 'New Title', 'Sheet1']

本教程到此結(jié)束。

水平有限强胰,如果有朋友發(fā)現(xiàn)文中許多翻譯不當(dāng)?shù)牡胤讲詹祝?qǐng)隨時(shí)指正。
翻譯不易偶洋,也請(qǐng)大家多多點(diǎn)贊熟吏!

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市玄窝,隨后出現(xiàn)的幾起案子牵寺,更是在濱河造成了極大的恐慌,老刑警劉巖恩脂,帶你破解...
    沈念sama閱讀 219,427評(píng)論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件帽氓,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡俩块,警方通過(guò)查閱死者的電腦和手機(jī)黎休,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,551評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門(mén),熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)玉凯,“玉大人奋渔,你說(shuō)我怎么就攤上這事∽嘲。” “怎么了嫉鲸?”我有些...
    開(kāi)封第一講書(shū)人閱讀 165,747評(píng)論 0 356
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)歹啼。 經(jīng)常有香客問(wèn)我玄渗,道長(zhǎng),這世上最難降的妖魔是什么狸眼? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 58,939評(píng)論 1 295
  • 正文 為了忘掉前任藤树,我火速辦了婚禮,結(jié)果婚禮上拓萌,老公的妹妹穿的比我還像新娘岁钓。我一直安慰自己,他們只是感情好微王,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,955評(píng)論 6 392
  • 文/花漫 我一把揭開(kāi)白布屡限。 她就那樣靜靜地躺著,像睡著了一般炕倘。 火紅的嫁衣襯著肌膚如雪钧大。 梳的紋絲不亂的頭發(fā)上,一...
    開(kāi)封第一講書(shū)人閱讀 51,737評(píng)論 1 305
  • 那天罩旋,我揣著相機(jī)與錄音啊央,去河邊找鬼眶诈。 笑死,一個(gè)胖子當(dāng)著我的面吹牛瓜饥,可吹牛的內(nèi)容都是我干的逝撬。 我是一名探鬼主播,決...
    沈念sama閱讀 40,448評(píng)論 3 420
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼乓土,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼宪潮!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起帐我,我...
    開(kāi)封第一講書(shū)人閱讀 39,352評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎愧膀,沒(méi)想到半個(gè)月后拦键,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 45,834評(píng)論 1 317
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡檩淋,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,992評(píng)論 3 338
  • 正文 我和宋清朗相戀三年芬为,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片蟀悦。...
    茶點(diǎn)故事閱讀 40,133評(píng)論 1 351
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡媚朦,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出日戈,到底是詐尸還是另有隱情询张,我是刑警寧澤,帶...
    沈念sama閱讀 35,815評(píng)論 5 346
  • 正文 年R本政府宣布浙炼,位于F島的核電站份氧,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏弯屈。R本人自食惡果不足惜蜗帜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,477評(píng)論 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望资厉。 院中可真熱鬧厅缺,春花似錦、人聲如沸宴偿。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 32,022評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)窄刘。三九已至消痛,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間都哭,已是汗流浹背秩伞。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 33,147評(píng)論 1 272
  • 我被黑心中介騙來(lái)泰國(guó)打工逞带, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人纱新。 一個(gè)月前我還...
    沈念sama閱讀 48,398評(píng)論 3 373
  • 正文 我出身青樓展氓,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親脸爱。 傳聞我的和親對(duì)象是個(gè)殘疾皇子业岁,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,077評(píng)論 2 355