Python標準ライブラリのカレンダーでLocaleTextCalendarクラスを適用する方法

Question

##経緯
Djangoで構築中のサイトにて、Python標準ライブラリのcalendarモジュールを用いて、現状でカレンダーを表示できているのですが英語表記です。

##質問

この英語表示を以下の解説ブログ記事のようにLocaleTextCalendarクラスを用いて日本語表記に変更したいのですが、適用方法がわかりません。

以下の公式リファレンスも参照しましたが、引き続き記述方法がわかりませんでした。
https://docs.python.org/ja/3/library/calendar.html

説明不足な点などは、適宜追記してまいりますので、アドバイスいただけますと誠にありがたく存じます。

##現状のスクリプト

import calendar

def next_month(d):
    # 以下の行を「calendar.LocaleTextCalendar.monthrange」などに編集したりしているのですが属性エラーになります。
    days_in_month = calendar.monthrange(d.year, d.month)[1]
    last = d.replace(day=days_in_month)
    next_month = last + timedelta(days=1)
    month = 'month=' + str(next_month.year) + '-' + str(next_month.month)
    return month

##参考にさせていただいている解説記事

https://torina.top/detail/380/

"""カレンダーのhtmlをコンソールに出力してみる."""
import calendar
my_calendar = calendar.LocaleHTMLCalendar()

Answer 1

calendarモジュールは使った事がありませんが、ざっと使ってみて回答します。

まず最初に、言語や地域の事を「locale」(ロケール)といいます。

あなたが動かそうとしている環境で日本語ロケールが使用できるか、確認しなければなりません。
「locale -a」というコマンドで、使用できるロケールの一覧が表示されるので、確認して下さい。

$ locale -a
C
C.UTF-8
POSIX
en_AG
en_AG.utf8
en_AU.utf8
en_BW.utf8
en_CA.utf8
en_DK.utf8
en_GB.utf8
en_HK.utf8
en_IE.utf8
en_IL
en_IL.utf8
en_IN
en_IN.utf8
en_NG
en_NG.utf8
en_NZ.utf8
en_PH.utf8
en_SG.utf8
en_US.utf8
en_ZA.utf8
en_ZM
en_ZM.utf8
en_ZW.utf8
ja_JP.utf8

一般的に、指定の言語を使用するには環境変数「LANG」に適切なロケールを設定します。

$ LANG=C date
Thu Oct 15 22:34:10 JST 2020
$ LANG=ja_JP.utf8 date
2020年 10月 15日 木曜日 22:34:40 JST

calendarモジュールを含むpythonのプログラムで言語設定をするには、localeモジュールのsetlocale関数を呼びます。

>>> import os, locale, calendar
>>> list(calendar.day_name)
['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday']
>>> os.environ['LANG']
'ja_JP.utf8'
>>> locale.setlocale(locale.LC_ALL, '')
'ja_JP.utf8'
>>> list(calendar.day_name)
['月曜日', '火曜日', '水曜日', '木曜日', '金曜日', '土曜日', '日曜日']

もし環境変数に影響せずに強制的に日本語ロケールに設定させたいのであれば、setlocale関数にロケールを指定します。

>>> locale.setlocale(locale.LC_ALL, 'ja_JP.utf8')
'ja_JP.utf8'
>>> list(calendar.day_name)
['月曜日', '火曜日', '水曜日', '木曜日', '金曜日', '土曜日', '日曜日']

なお、LocaleTextCalendar/LocaleHTMLCalendarは、localeモジュールを使わずともロケールに沿った表示をするようです。
デフォルトでは環境変数LANGを見るようですが、コンストラクタのlocale引数にロケールを設定すれば、そのロケール設定で処理されるようです。

>>> import os, calendar
>>> os.environ['LANG']
'C'
>>> print(calendar.LocaleTextCalendar().formatmonth(2020, 10))
    October 2020
Mo Tu We Th Fr Sa Su
          1  2  3  4
 5  6  7  8  9 10 11
12 13 14 15 16 17 18
19 20 21 22 23 24 25
26 27 28 29 30 31

>>> print(calendar.LocaleTextCalendar(locale='ja_JP.utf8').formatmonth(2020, 10))
      10月 2020
月  火  水  木  金  土  日
          1  2  3  4
 5  6  7  8  9 10 11
12 13 14 15 16 17 18
19 20 21 22 23 24 25
26 27 28 29 30 31

Comments

[fukazume]

詳説いただき誠にありがとうございます！お返事がおそくなり大変申し訳ございません！m(__)m ロケール設定の体系も理解しやすい段取りでご解説いただけたので、おかげさまでロケール変更が無事にできカレンダー表記も日本語に更新されました！

教えて頂いた手順にて、当初ロケールがC.UTF-8のみの状態だったことが原因でlocale.setlocale(locale.LC_ALL, 'ja_JP.utf8')でエラーlocale.Error: unsupported locale settingが出ていたことが判明いたしました。

ロケールの理解が深まりました。改めまして深く御礼申し上げます！