【Python】openpyxl：基本的なエクセル操作方法を徹底解説

openpyxlでのエクセルファイル構成

エクセルはエクセルファイル本体であるスプレッドシート（ブック）、その中に複数あるシート、シートに無数にあるセルで構成されています。

これらをopenpyxlではオブジェクトとして扱います。

• スプレッドシート（ブック）：Workbookオブジェクト
• シート：Worksheetオブジェクト
• セル：Cellオブジェクト

openpyxlでは、これらオブジェクトを操作してエクセルを編集していきます。

新規でエクセルファイルを作成（Workbook()関数）

新規にExcelファイルを作成する場合は、Workbookオブジェクトを作成します。
Workbookオブジェクトの作成にはopenpyxl.Workbook()関数を使用します。

import openpyxl
wb = openpyxl.Workbook()

新規でエクセルを作成すると、そのエクセル内には自動的に「Sheet」という名前のワークシートが作成されます。

wb = openpyxl.Workbook()
wb.get_sheet_names()
# ['Sheet']

既存エクセルを開く（load_workbook()関数）

既存のエクセルファイルを開く場合は、openpyxl.load_workbook()関数を使用します。

引数には開きたいエクセルのパス＋ファイル名をとり、そのエクセルファイルのWorkbookオブジェクトを返します。

import openpyxl
wb = openpyxl.load_workbook('office54.xlsx')

読み込んだブックに対して書き込みをしたくない場合は、引数にread_only = Trueを与えます。
この引数を与えることで、読み込み専用でブックを取得できます。

wb = openpyxl.load_workbook('office54.xlsx', read_only = True)

load_workbook()関数にはこれ以外にも指定できる引数があります。
必要に応じて使い分けましょう。

アクティブシートのWorksheetオブジェクト取得

エクセルのアクティブになっているWorksheetオブジェクトを取得するには、Workbookオブジェクトに対してactiveを使用します。

wb = openpyxl.load_workbook('office54.xlsx')
ws = wb.active

activeをWorkbookオブジェクトに使用することで、アクティブシートのWorksheetオブジェクトが返されます。

シート名からWorksheetオブジェクト取得

シート名からそのシートのWorksheetオブジェクトを取得する方法は以下になります。

wb = openpyxl.load_workbook('office54.xlsx')
ws = wb['Sheet1']

またget_sheet_by_name()関数を使ってシート名からWorksheetオブジェクトを取得することができます。

wb = openpyxl.load_workbook('office54.xlsx')
ws = wb.get_sheet_by_name('Sheet1')

しかし廃止が予定されているのか、現在get_sheet_by_name()関数を使用すると以下の警告が表示されます。

DeprecationWarning: Call to deprecated function get_sheet_by_name (Use wb[sheetname]).

そのためシート名からWorksheetオブジェクトを取得する場合は、前述の方法がおすすめです。

シートのインデックスからWorksheetオブジェクト取得

エクセルのシートは左からインデックス番号が0、１と付いています。
そのインデックスを指定して、シートのWorksheetオブジェクトを取得します。

シートのインデックスからWorksheetオブジェクトを取得するには、worksheets[]をWorkbookオブジェクトに対して使用します。

wb = openpyxl.load_workbook('office54.xlsx')
ws = wb.worksheets[0]

シートの挿入：creat_sheet()メソッド

新規にシートを挿入するにはWorkbookオブジェクトに対してcreate_sheet()メソッドを使います。

wb = openpyxl.load_workbook('office54.xlsx')
print(wb.sheetnames)
# ['Sheet']

wb.create_sheet()
print(wb.sheetnames)
# ['Sheet', 'Sheet1']

sheet()メソッドに引数を与えない場合は、Sheet＊という名前が付けられます。
シート名を指定したい場合は、引数にシート名を与えます。

wb = openpyxl.load_workbook('office54.xlsx')
print(wb.sheetnames)
# ['Sheet']

wb.create_sheet('OFFICE54')
print(wb.sheetnames)
# ['Sheet', 'OFFICE54']

またシートが挿入される位置は、デフォルトでは末尾です。
挿入される位置を変更したい場合は、引数のシート名の後に挿入したいインデックス番号を入れます。

wb = openpyxl.load_workbook('office54.xlsx')
print(wb.sheetnames)
# ['Sheet']

wb.create_sheet('OFFICE54')
print(wb.sheetnames)
# ['Sheet', 'OFFICE54']

wb.create_sheet('No.0', 0)
print(wb.sheetnames)
# ['No.0', 'Sheet', 'OFFICE54']

wb.create_sheet('No.1', 1)
print(wb.sheetnames)
# ['No.0', 'No.1', 'Sheet', 'OFFICE54']

シートの削除：remove()メソッド、del文

シートを削除する方法は２種類あります。

• Workbookオブジェクトに対してremove()メソッドを用いる
• del文でWorksheetオブジェクトを指定して削除する

以下のサンプルプログラムを見ていただいて、使い方を確認してください。

wb = openpyxl.load_workbook('office54.xlsx')
print(wb.sheetnames)
# ['Sheet']

wb.create_sheet('OFFICE54')
print(wb.sheetnames)
# ['Sheet', 'OFFICE54']

wb.create_sheet('No.0', 0)
print(wb.sheetnames)
# ['No.0', 'Sheet', 'OFFICE54']

wb.create_sheet('No.1', 1)
print(wb.sheetnames)
# ['No.0', 'No.1', 'Sheet', 'OFFICE54']

シート：シート名の変更

シート名を変更するには、Worksheetオブジェクトのtitle属性を変更します。

wb = openpyxl.load_workbook('office54.xlsx')
ws = wb['Sheet1']
ws.title = "OFFICE54"

セル番地を指定して取得

Worksheetオブジェクトに対して、セル番地を与えることで、Cellオブジェクトを取得することができます。

wb = openpyxl.load_workbook('office54.xlsx')
ws = wb['Sheet']
print(ws['A1'].value)
# 54

cell()メソッドを用いて取得

Worksheetオブジェクトにcell()メソッドを用いることで、Cellオブジェクトが取得できます。

cell()メソッドの引数には、セルの行番号と列番号を与えます。

wb = openpyxl.load_workbook('office54.xlsx')
ws = wb['Sheet']
print(ws.cell(1,1).value)

前述のセル番地でCellオブジェクトを取得する方が直感的に簡単です。

しかしcellメソッドは繰り返し処理で、列または行が変わる処理で威力を発揮します。

プログラムによってCellオブジェクトの取得方法は使い分けましょう。

行の挿入・削除

行の挿入は、Worksheetオブジェクトに対して、insert_rows()メソッドを用います。

行の削除は、Worksheetオブジェクトに対して、delete_rows()メソッドを用います。

wb = openpyxl.load_workbook('office54.xlsx')
ws = wb['Sheet']

# 2行目に行を挿入する
ws.insert_rows(2)

# 4行目に行を4行挿入する
ws.insert_rows(4, 4)

# 3行目を削除する
ws.delete_rows(3)

# 5行目から7行目までを削除する
ws.delete_rows(5, 7)

列の挿入・削除

列の挿入は、Worksheetオブジェクトに対して、insert_cols()メソッドを用います。

行の削除は、Worksheetオブジェクトに対して、delete_cols()メソッドを用います。

wb = openpyxl.load_workbook('office54.xlsx')
ws = wb['Sheet']

# 2列目に列を挿入する
ws.insert_cols(2)

# 4列目に列を4列挿入する
ws.insert_cols(4, 4)

# 3列目を削除する
ws.delete_cols(3)

# 5列目から7列目までを削除する
ws.delete_cols(5, 7)

列幅の変更（column_dimensions）

列幅はWorksheetオブジェクトに対して、column_dimensionsを用います。

column_dimensionsに列番号を与え、width属性を変更することで列幅を変更できます。

wb = openpyxl.load_workbook('office54.xlsx')
ws = wb['Sheet']
ws.column_dimensions['A'].width = 25

行高の変更（row_dimensions）

行高はWorksheetオブジェクトに対して、row_dimensionsを用います。

row_dimensionsに行番号を与え、height属性を変更することで行高を変更できます。

wb = openpyxl.load_workbook('office54.xlsx')
ws = wb['Sheet']
ws.row_dimensions[3].height = 25

行ごとにCellオブジェクトを取得

行ごとにCellオブジェクトを取得するには、Worksheetオブジェクトに対して取得したい「行数」を指定します。

row = ws[3]
print(row)
# (<Cell 'Sheet'.A3>,)
for cell in row:
	print(cell.value)

列ごとにCellオブジェクトを取得

列ごとにCellオブジェクトを取得するには、Worksheetオブジェクトに対して取得したい「列数」を指定します。
行数とは異なり数値ではなく、アルファベットで指定します。

col = ws['C']
print(col)
for cell in col:
	print(cell.value)

上記では１列のみを指定しましたが、複数列を指定することも可能です。

col = ws[1:3]
print(col)