[xlwingsでシート名を変更]1行で実現！業務効率UP

過去の自分

xlwingsでエクセルを編集しているんだけど、
わかりやすいように途中でシート名を変更したい…。

今の自分

なるほど…。
では今回は、
「xlwingsでシート名を変更する方法」を
できるだけわかりやすく解説いたします。
また、「シート名を変更する際の注意点」
も紹介いたします。

【著者情報】
Python歴３年。
入社２年目の春に先輩が突然トンズラし、業務を半分肩代わりするハメに…。
今までの1.5倍の仕事をこなせるはずもなく、苦しむ毎日。
業務効率化を模索中にPythonと出合う。
業務とPythonの相性が良く、２倍以上の効率化を実現。現在も効率化を進行中。

スポンサードリンク

xlwingsでシート名を変更するには
うまく動作しない時
最後に

xlwingsでシート名を変更するには

「name」を使います。まずは実行見本をどうぞ。

実行見本

全コード

ひとまず全コードを網羅します。解説は後ほど行います。

import xlwings

workbook = xlwings.books.active
worksheet = workbook.sheets.active

worksheet.name = '改名'

worksheet.name = '改名'

xlwingsの処理は、予想以上に時間がかかることがあります。
プログラムの最後に「print(‘実行完了’)」などを追記し、完了したのを確認してから結果を見ましょう。

事前準備

xlwingsのインストール

エクセルファイルを実際に操作するには、「xlwings」のインストールが必要になります。

xlwingsのインストール方法

xlwingsを初めて使用する場合は、下記コードを入力・実行して、インストールしてください。

pip install xlwings

※xlwingsを使用したことがある場合は、このインストール作業は不要です。

インストール方法詳細やインストールができない場合の対処法、
基本的な使い方などは下記記事をご参考ください。

解説

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

インポート～シートの取得

import xlwings

workbook = xlwings.books.active
worksheet = workbook.sheets.active

上記コードにて、「xlwingsのインポート」「アクティブブック・アクティブシートの取得」をしています。
詳細は「アクティブシートの取得」の記事をご覧ください。

シート名の変更

worksheet.name = '改名'

上記一文にて、取得したシートのシート名を変更することができます。

左辺には「取得したシート変数」に続けて「.name」を記述します。
右辺は「変更後のシート名」を記述してください。

＜テンプレ＞
【　シートが入った変数.name = ‘変更後のシート名‘　】

シート名を変更する際の注意点

「*」や「?」など、実際にシート名に使うことができない文字を指定することはできません。

エラーが出るわけではありませんが、動作せずにフリーズする場合がありますので、ご注意ください。
記号は使わず、漢字・英字・数字の中からシート名を決めるのが無難です。

また、指定した名前のシートが既に存在する場合も、同様にフリーズすることがあります。
シート名は重複しないようにしましょう。

スポンサードリンク

うまく動作しない時

エラーが出る

‘NoneType’ object has no attribute ‘books’

エクセルブックやエクセルファイルを開いていないのに、ブックやファイルを取得しようとした場合に出るエラーです。
事前に対象のファイルを開くように指定するなど、構文を見直してみましょう。

○○ is not defined

今まで出てきていない変数などを処理しようとした時に出るエラーです。
変数名などが間違っていないかチェックしましょう。

詳しい解説は、下記記事をご参考ください。

その他のエラー

その他のエラーが出た場合は、エラー文をコピーしてNETで検索してみましょう。

空のブックが生成される・残る

作業環境によっては「空のブック（Book1）」が生成されたり、残ってしまう場合があります。
このまま作業を続けると、空のブックがどんどん増えていく可能性があるため対処が必要です。

対処法としましては、何か別のエクセルを開いたままにしておきましょう。
そうすることで、空のブックは生成されません。

作業を始める前に、適当なエクセルファイルをひとつ開いておくことをおすすめします。

いつまでたっても実行されない

エラーは出ていないのに、いつまでたっても実行されない場合は、実行内容がエクセルに届いていない可能性があります。
「books.active」「sheets.active」を使用していて、エクセルファイルが最小化されていると、実行内容がエクセルに届かない場合があります。（もう１度実行すると、同じ内容が２回実行される）

エクセルは最小化せず、コードエディタとエクセルを並べて表示させた状態で実行するとうまくいきやすいです。