【Python】openpyxlでExcelのシートを読み込み・追加・新規作成・コピー・名前の変更する方法

2020年11月21日
2021年7月11日
Python
copy_worksheetメソッド, create_sheetメソッド, DeprecationWarning, Excel, openpyxl.load_workbook関数, openpyxlモジュール, remove_sheetメソッド, removeメソッド, sheetnames属性, title属性, Workbookオブジェクト, Worksheetオブジェクト

Python

PythonでExcel操作をするためにはopenpyxlモジュールが必要です。pipでインストールしてから使う必要があります。

以下ではワークブック（Excelファイル）は開いているものとして解説していきます。これから紹介するメソッドや関数は以下のコードの下に続いているものとして考えてください。

>>> import openpyxl
>>> path = r"C:\Documents\sample.xlsx"
>>> wb = openpyxl.load_workbook(path)
#この続きのコードを紹介します。

#最後は必ず保存します。
>>> wb.save(path)

>>> import openpyxl

>>> path = r"C:\Documents\sample.xlsx"

>>> wb = openpyxl.load_workbook(path)

#この続きのコードを紹介します。

#最後は必ず保存します。

>>> wb.save(path)

Excelファイルの読み込みからシートの取得までの方法は以下の記事にまとめています。

【Python】openpyxlでExcelを読み込む方法【ワークブックからシートの指定まで】

PythonでExcel操作をするときには必ずファイル（ワークブック）の読み込みからシートの指定をする必要があります。今回はそんな基本的な部分のコードの書き方を3ステップで紹介していきます。 1：openpyxlモジュールの[…]

Excelファイルが開かれるとWorbookオブジェクトが作られます。ワークシートを開くとWorksheetオブジェクトが作られます。

1 シートを読み込み
2 シートを追加（新規作成）
3 シートを削除
4 シートをコピー
5 シートの名前を変える
6 まとめ

シートを読み込み

Workbookオブジェクトにシート名を指定

>>> sheet = wb['シート1']

1	>>> sheet = wb['シート1']

辞書のようにシート名をキーとして指定するとWorksheetオブジェクトを作ることができます。

その他のシートを読み込む方法は以下の記事にまとめいています。

【Python】openpyxlでExcelを読み込む方法【ワークブックからシートの指定まで】

シートを追加（新規作成）

create_sheetメソッドを使う
引数なしなら「Sheet」を末尾に追加
indexとtitleをキーワード引数で渡せる

#引数なしなら末尾に追加
>>> wb.create_sheet()
<Worksheet "Sheet">
>>> wb.sheetnames #シート名一覧を取得
['シート1', 'Sheet']

#シート名を指定
>>> wb.create_sheet(title='新シート')
<Worksheet "新シート">
>>> wb.sheetnames
['シート1', 'Sheet', '新シート']

#インデックスを指定
>>> wb.create_sheet(index=2)
<Worksheet "Sheet1">
>>> wb.sheetnames
['シート1', 'Sheet', 'Sheet1', '新シート']

#インデックスとシート名を指定
>>> wb.create_sheet(index=0, title='先頭')
<Worksheet "先頭">
>>> wb.sheetnames
['先頭', 'シート1', 'Sheet', 'Sheet1', '新シート']

#引数なしなら末尾に追加

>>> wb.create_sheet()

>>> wb.sheetnames #シート名一覧を取得

['シート1', 'Sheet']

#シート名を指定

>>> wb.create_sheet(title='新シート')

>>> wb.sheetnames

['シート1', 'Sheet', '新シート']

#インデックスを指定

>>> wb.create_sheet(index=2)

>>> wb.sheetnames

['シート1', 'Sheet', 'Sheet1', '新シート']

#インデックスとシート名を指定

>>> wb.create_sheet(index=0, title='先頭')

>>> wb.sheetnames

['先頭', 'シート1', 'Sheet', 'Sheet1', '新シート']

キーワード引数はインデックスだけでもタイトルだけでも構いません。インデックスだけ指定するとシート名は自動で割り振られます。

インデックスの指定方法はリストと同じように0から始まる整数を使いいます。

sheetnames属性を使うとワークブックないのシート名一覧を取得できます。

シートを削除

remove_sheetメソッドを使う
- 警告が出ますが削除できます
removeメソッドを使う
- 引数にWorksheetオブジェクトを渡す
del文を使う

#最初の状態
>>> wb.sheetnames
['先頭', 'シート1', 'Sheet', 'Sheet1', '新シート']
>>> sheet = wb['新シート']

#警告は出ますが削除できています
>>> wb.remove_sheet(sheet)
Warning (from warnings module):
  File "<pyshell#13>", line 1
DeprecationWarning: Call to deprecated function remove_sheet
 (Use wb.remove(worksheet) or del wb[sheetname]).

>>> wb.sheetnames
['先頭', 'シート1', 'Sheet', 'Sheet1']

#推奨のメソッド
>>> sheet = wb['Sheet1']
>>> wb.remove(sheet)
>>> wb.sheetnames
['先頭', 'シート1', 'Sheet']

>>> wb.remove(wb['Sheet'])
>>> wb.sheetnames
['先頭', 'シート1']

#del文
>>> del wb['先頭']
>>> wb.sheetnames
['シート1']

#最初の状態

>>> wb.sheetnames

['先頭', 'シート1', 'Sheet', 'Sheet1', '新シート']

>>> sheet = wb['新シート']

#警告は出ますが削除できています

>>> wb.remove_sheet(sheet)

Warning (from warnings module):

File "<pyshell#13>", line 1

DeprecationWarning: Call to deprecated function remove_sheet

(Use wb.remove(worksheet) or del wb[sheetname]).

>>> wb.sheetnames

['先頭', 'シート1', 'Sheet', 'Sheet1']

#推奨のメソッド

>>> sheet = wb['Sheet1']

>>> wb.remove(sheet)

>>> wb.sheetnames

['先頭', 'シート1', 'Sheet']

>>> wb.remove(wb['Sheet'])

>>> wb.sheetnames

['先頭', 'シート1']

#del文

>>> del wb['先頭']

>>> wb.sheetnames

['シート1']

「DeprecationWarning」とう警告文は「remove_sheetメソッドではなく「removeメソッドかdel文を使ってね」という内容です。

シートをコピー

copy_worksheetメソッドを使う
引数にWorksheetオブジェクトを渡す

#最初の状態
>>> wb.sheetnames
['シート1']

#コピーを作成
>>> wb.copy_worksheet(wb['シート1'])
<Worksheet "シート1 Copy">
>>> wb.sheetnames
['シート1', 'シート1 Copy']

#最初の状態

>>> wb.sheetnames

['シート1']

#コピーを作成

>>> wb.copy_worksheet(wb['シート1'])

>>> wb.sheetnames

['シート1', 'シート1 Copy']

シートの名前を変える

title属性を変更する

#最初の状態
>>> wb.sheetnames
['シート1']
>>> sheet = wb['シート1']
#変更前シート名の確認
>>> sheet.title
'シート1'

#シート名の変更
>>> sheet.title = 'シート改'

#変更後シート名の確認
>>> sheet.title
'シート改'