Pythonまとめ（openpyxlライブラリ）

エクセル操作（openpyxl）

openpyxlライブラリを使うとエクセルファイルの操作が行える。注意点としてこのライブラリは数式の計算はできない。なのでopenpyxlでデータを更新したとしても、その計算結果をopenpyxlで取得することはできない。それにはopenpyxlでデータの更新だけ行い、再計算はExcelに委ねる。なお、Excelは最後の計算結果を保存しているため、最後にファイルを保存したときの計算結果は取得できる。

本稿では既存のエクセルファイルを単純に読み書きするための操作を中心に記載しており、条件付き書式やビュー、テーブル、チャートなどの項目については記載していない。

クラス構造

openpyxlでは主にWorkbook、Worksheet、Cellの3つのクラスを扱う。エクセルファイルがWorkbook、シートがWorksheet、セルがCellに対応している。

Workbook

エクセルファイルに相当するのがWorkbookである。ファイルをオープンすれば作成される。なお、openpyxlで開いたエクセルをそのまま保存すると一部データが失われることがあるため、別名で保存するが、保存しないで閉じること。

>>> excel = openpyxl.load_workbook(file, data_only=True)
>>> type(excel)
<class 'openpyxl.workbook.workbook.Workbook'>

既存のエクセルファイルを開くのではなく、新規に作成するのであれば新規オブジェクトを作成するだけでよい。そうすれば1つのシートを持つWorkbookが作成される。

>>> wb = openpyxl.Workbook()
>>> type( wb )
<class 'openpyxl.workbook.workbook.Workbook'>

Workbookの作成・保存

openpyxl.load_workbook関数でエクセルファイルを開き、Workbookオブジェクトを得られる。load_workbookでは引数で以下のオプションを指定できる。

保存するにはWorkbook.saveメソッドを使う。繰り返しとなるがopenpyxlではデータが失われることがあるため別名保存を基本としたほうが良い。

Workbookの操作

Workbookはファイル全体で共通な情報やワークシートの情報を保持しており、それらを追加や削除するメソッドも提供している。

Worksheet

Worksheetではシート個別の情報やシート内のセルを取得するためのメソッドが提供される。

セルアクセス

Cell

Cellではそのセルの座標や値に関する情報を取得できる。

ユーティリティ

エクセル操作に役立つユーティリティも用意されている。以下のソッドはいずれもopenpyxl.utils.cellモジュールにありインポートが必要である。

サンプル

いくつかエクセル操作のサンプルを示す。

単純なデータの読み込み

指定範囲の参照

import openpyxl 

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

for row in ws.iter_rows(1,3,1,3):
    for cell in row:
        print( cell.value, end="")
    print()

A1B1C1
A2B2C2
A3B3C3

全データの処理

import openpyxl

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

for rowvalues in ws.values:
    print( rowvalues )

(1, None, None, None, None)
(None, 2, None, None, None)
(None, None, 3, None, None)
(None, None, None, 4, None)
(None, None, None, None, 5)

空白セルのvalueにはNoneが入っている。Noneを手軽に空文字列にしたいならcell.value or ''でできる。ただし、これは論理値Falseが入っているときも空文字になるため、論理値が入っていない前提のときに使うか、cell.value if cell.value is not None else ''のようちゃんとチェックする。

様々なデータのタイプ

B4,C4には数式が入っており、D4は文字列＃N/Aが入っている

import openpyxl

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

for row in ws:
    for cell in row:
        print(f"{cell.value} {type(cell.value).__name__} {cell.data_type}")
    print()

エラーは単なる文字列であり、data_typeではエラーの文字列と一致しているか見ているだけなので、D4の文字列#N/Aもエラーとして判定される。