【openpyxl】エクセルの読み込み方法まとめ【徹底解説！】

過去の自分

openpyxlでエクセルファイルを読み込みしたいんだけど、
シート名が毎回違ったりしてエラーが出る…。
シートの位置も違う時があるし、なんかいい方法は無いの？

今の自分

なるほど…。
では今回は、「openpyxlでエクセルを読み込みする方法」をまとめて紹介いたします。
できるだけわかりやすく解説いたしますので、ぜひ最後まで読んでいってください。

スポンサードリンク

openpyxlでエクセル（ブック）を読み込みする方法
openpyxlでエクセル（シート）を読み込みする方法
うまく動作しない場合の対処法
1. エラーが出る
最後に

openpyxlでエクセル（ブック）を読み込みする方法

※わかりやすさを重視しております。厳密には解釈が異なる場合がありますことをご了承ください。

今回サンプルとして読み込みするファイルは下図のとおり、シートが３つあるエクセルファイルです。

エクセルファイルを読み込み・編集するには、まずはエクセルファイルのブックを読み込みする必要があります。
コードは以下のとおりです。

import openpyxl

wb = openpyxl.load_workbook('C:/Utatane/input.xlsx')

1行目の「インポート」は解説を割愛します。また「openpyxl」を初めて使う場合はインストールが必要です。
下記の「インストールを解説した記事」をご参考ください。

3行目でエクセルファイルのブックを読み込みしています。

まず新しい名前の変数を書いたら、「=（イコール）」を書きます。

今回はわかりやすくするため、変数名を「WorkBook」略して「wb」という名前にしていますが、なんでも構いません。
しかしながら、つけることができない名前があったり、注意すべきこともありますので、下記記事を事前にご覧ください。

イコールの後に、「openpyxl.load_workbook()」を書きます。
()内の引数には、「読み込みするファイルのアドレス」を書いてください。

アドレスはフルパス（フォルダパス/ファイル名）で指定するのが無難です。
フォルダパスは、ファイルが置いてあるフォルダを開き、アドレスバーからコピーできます。

アドレスをコードにコピペした後、「/」が「\」や「￥」になってしまっている場合は、「/」に変更してください。

「2024input.xlsx」「input001.xlsx」などのように、ファイル名が毎回微妙に違う場合は、「glob」を使うと便利です。

import openpyxl
import glob

files = glob.glob('C:/Utatane/*input*.xlsx')

wb = openpyxl.load_workbook(files[0])

【4行目】
ファイル名の両サイドに「*（アスタリスク）」が追加されています。
これで、ファイル名に「input」が含まれるファイルが読み込みされ、配列「files」に入ります。
配列については下記記事をご参考ください。

【6行目】
これまで解説したコードとほぼ同じですが、()内の引数には4行目で取得した配列の0番目を指定します。

【注意点】
フォルダ内に「input」を含むファイルが複数ある場合は、想定していないファイルを読み込みする可能性がありますのでご注意ください。

これで、エクセルファイルのブックが読み込みされます。
エラーが出た場合は、「うまく動作しない場合の対処法」の項をご参考ください。

次に、シートを読み込みする方法を見ていきましょう。

スポンサードリンク

openpyxlでエクセル（シート）を読み込みする方法

シートを読み込みする方法を3つ紹介いたします。

アクティブシートを指定して読み込み
シート名を指定して読み込み
シート番号を指定して読み込み

それぞれ「メリット」と「デメリット」があります。
１つ１つ見ていきましょう。

アクティブシートを指定して読み込み

まずは「アクティブシートを指定して読み込み」する方法です。
アクティブシートとは、「最終保存する直前に選択されていたシート」のことで、下図の場合は「Sheet2」がアクティブシートとなります。

では、このアクティブシートである「Sheet2」を読み込んでみましょう。

import openpyxl

wb = openpyxl.load_workbook('C:/Utatane/input.xlsx')
ws = wb.active

コードの3行目は前項で解説した「ブック」を読み込む方法でしたね。
コードの4行目でアクティブシートを読み込みしています。

新しい名前の変数を書いたらイコールを書き、ブックを読み込んだ変数に続けて「.active」を書きます。
これでアクティブシートを読み込むことができます。
※メリット・デメリットは後述

シート名を指定して読み込み

次に、「シート名を指定して読み込み」する方法を見ていきましょう。
シート名である「Sheet1」を指定して読み込んでみましょう。

import openpyxl

wb = openpyxl.load_workbook('C:/Utatane/input.xlsx')
ws = wb['Sheet1']

4行目を見てください。
アクティブシートの読み込み方法と似ていますが、右辺が違います。

ブックを読み込んだ変数の後に、[]を書きます。
[]内にシート名を記述してください。

【注意点】
1.シート名は「’（クォーテーション）」で囲ってください。
2.デフォルト名である「Sheet1」の先頭は大文字の「S」です。「sheet1」とならないようにしましょう。

シート番号を指定して読み込み

最後に「シート番号を指定して読み込み」する方法を紹介いたします。

import openpyxl

wb = openpyxl.load_workbook('C:/Utatane/input.xlsx')
ws = wb.worksheets[0]

4行目の右辺で、ブックを読み込んだ変数に続けて、「.worksheets[]」を書きます。
[]内には「シート番号」を記述してください。

【シート番号とは】
シートの順番を表す番号です。
1番左のシートは[0]となります。[1]ではないので間違えないようにしましょう。
左から2番目のシートは[1]、左から3番目のシートは[2]となります。
シート番号[-1]を指定すると、一番右のシート（下図ではSheet3）を読み込みすることができます。