毎週1つのPythonモジュール|calendar

8035 ワード

calendarモジュール定義Calendarクラスで、指定された月または年の中週の日付を計算するなど、値の計算がカプセル化されています.また、TextCalendarおよびHTMLCalendarクラスは、プリフォーマットされた出力を生成することができる.
フォーマットの例prmonth()方法は簡単で、1ヶ月のフォーマットテキスト出力を生成できます.
import calendar

c = calendar.TextCalendar(calendar.SUNDAY)
c.prmonth(2017, 7)

#   
#      July 2017
# Su Mo Tu We Th Fr Sa
#                    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
TextCalendar米国の慣例によれば、この例は日曜日から週を開始するように構成されている.デフォルトは月曜日から1週間のヨーロッパの慣例を使用します.HTMLCalendarおよびformatmonth()HTMLのような表を生成することができます.表示される出力は純テキストとほぼ同じように見えますが、HTMLタグで包装されています.各テーブル・セルには曜日に対応するクラス属性があるため、HTMLはCSSでスタイルを設定できます.
いずれかのデフォルト値と異なる形式で出力を生成するには、calendar日付を計算し、週と月の範囲に値を整理して結果を反復します.Calendarモジュールのweekheader()monthcalendar()およびyeardays2calendar()方法は特に有用である.
呼び出しyeardays2calendar()一連の「月行」リストが生成されます.各リストには、月が別の週のリストとして含まれます.ここ数週間は、日付番号(1-31)と平日番号(0-6)からなるメタグループのリストです.月を超えた日数は0です.
import calendar
import pprint

cal = calendar.Calendar(calendar.SUNDAY)

cal_data = cal.yeardays2calendar(2017, 3)
print('len(cal_data)      :', len(cal_data))

top_months = cal_data[0]
print('len(top_months)    :', len(top_months))

first_month = top_months[0]
print('len(first_month)   :', len(first_month))

print('first_month:')
pprint.pprint(first_month, width=65)

#   
# len(cal_data)      : 4
# len(top_months)    : 3
# len(first_month)   : 5
# first_month:
# [[(1, 6), (2, 0), (3, 1), (4, 2), (5, 3), (6, 4), (7, 5)],
#  [(8, 6), (9, 0), (10, 1), (11, 2), (12, 3), (13, 4), (14, 5)],
#  [(15, 6), (16, 0), (17, 1), (18, 2), (19, 3), (20, 4), (21, 5)],
#  [(22, 6), (23, 0), (24, 1), (25, 2), (26, 3), (27, 4), (28, 5)],
#  [(29, 6), (30, 0), (31, 1), (0, 2), (0, 3), (0, 4), (0, 5)]]

使用に相当formatyear().
import calendar

cal = calendar.TextCalendar(calendar.SUNDAY)
print(cal.formatyear(2017, 2, 1, 1, 3))

#   
#                               2017
# 
#       January               February               March
# Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa
#  1  2  3  4  5  6  7            1  2  3  4            1  2  3  4
#  8  9 10 11 12 13 14   5  6  7  8  9 10 11   5  6  7  8  9 10 11
# 15 16 17 18 19 20 21  12 13 14 15 16 17 18  12 13 14 15 16 17 18
# 22 23 24 25 26 27 28  19 20 21 22 23 24 25  19 20 21 22 23 24 25
# 29 30 31              26 27 28              26 27 28 29 30 31
# 
#        April                  May                   June
# Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa
#                    1      1  2  3  4  5  6               1  2  3
#  2  3  4  5  6  7  8   7  8  9 10 11 12 13   4  5  6  7  8  9 10
#  9 10 11 12 13 14 15  14 15 16 17 18 19 20  11 12 13 14 15 16 17
# 16 17 18 19 20 21 22  21 22 23 24 25 26 27  18 19 20 21 22 23 24
# 23 24 25 26 27 28 29  28 29 30 31           25 26 27 28 29 30
# 30
# 
#         July                 August              September
# Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa
#                    1         1  2  3  4  5                  1  2
#  2  3  4  5  6  7  8   6  7  8  9 10 11 12   3  4  5  6  7  8  9
#  9 10 11 12 13 14 15  13 14 15 16 17 18 19  10 11 12 13 14 15 16
# 16 17 18 19 20 21 22  20 21 22 23 24 25 26  17 18 19 20 21 22 23
# 23 24 25 26 27 28 29  27 28 29 30 31        24 25 26 27 28 29 30
# 30 31
# 
#       October               November              December
# Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa  Su Mo Tu We Th Fr Sa
#  1  2  3  4  5  6  7            1  2  3  4                  1  2
#  8  9 10 11 12 13 14   5  6  7  8  9 10 11   3  4  5  6  7  8  9
# 15 16 17 18 19 20 21  12 13 14 15 16 17 18  10 11 12 13 14 15 16
# 22 23 24 25 26 27 28  19 20 21 22 23 24 25  17 18 19 20 21 22 23
# 29 30 31              26 27 28 29 30        24 25 26 27 28 29 30
#                                             31
day_name,day_abbr,month_name,およびmonth_abbrモジュールは、主にカスタムフォーマット出力(つまりHTML出力リンクに含まれる)の製造に使用される.現在の領域に対して構成が自動化されます.
領域の設定
非デフォルト領域のフォーマットカレンダーを生成する場合は、LocaleTextCalendarまたはLocaleHTMLCalendarを使用します.
import calendar

c = calendar.LocaleTextCalendar(locale='en_US')
c.prmonth(2017, 7)

print()

c = calendar.LocaleTextCalendar(locale='fr_FR')
c.prmonth(2017, 7)

#   
#      July 2017
# 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
#
#     juillet 2017
# Lu Ma Me Je Ve Sa Di
#                 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

週の初日は言語環境設定の一部ではなく、この値はTextCalendarのようにクラスのパラメータです.
計算日
カレンダーモジュールは、主に様々なフォーマットで完全なカレンダーを印刷することに重点を置いていますが、重複イベントの日付を計算するなど、他の方法で日付を処理する有用な機能も提供します.
たとえば、Pythonアトランタのユーザーグループは、毎月の第2木曜日に会議を開きます.年の会議日を計算するには、monthcalendar()を使用します.
import calendar
import pprint

pprint.pprint(calendar.monthcalendar(2017, 7))

#   
# [[0, 0, 0, 0, 0, 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, 0, 0, 0, 0, 0, 0]]

0の値は、指定した月と重なる1週間の時間で、別の月の一部です.
週の初日のデフォルトは月曜日です.setfirstweekday()を呼び出すことで変更できますが、カレンダーモジュールにはインデックスが返す日付範囲の定数monthcalendar()が含まれているため、この場合はスキップしたほうが便利です.
1年間のグループミーティングの日付を計算するには、毎月の第2木曜日に、表示monthcalendar()出力して木曜日を検索するとします.今月の最初の週と最後の週には、前の月または後の月の日数のプレースホルダとして0値を入力します.たとえば、月が金曜日に始まると、木曜日の位置の最初の週の値は0になります.
import calendar
import sys

year = int(sys.argv[1])

# Show every month
for month in range(1, 13):

    # Compute the dates for each week that overlaps the month
    c = calendar.monthcalendar(year, month)
    first_week = c[0]
    second_week = c[1]
    third_week = c[2]

    # If there is a Thursday in the first week,
    # the second Thursday is # in the second week.
    # Otherwise, the second Thursday must be in
    # the third week.
    if first_week[calendar.THURSDAY]:
        meeting_date = second_week[calendar.THURSDAY]
    else:
        meeting_date = third_week[calendar.THURSDAY]

    print('{:>3}: {:>2}'.format(calendar.month_abbr[month], meeting_date))

#       
# Jan: 12
# Feb:  9
# Mar:  9
# Apr: 13
# May: 11
# Jun:  8
# Jul: 13
# Aug: 10
# Sep: 14
# Oct: 12
# Nov:  9
# Dec: 14

その他の有用な関数のリスト
シーケンス番号
関数と説明
1
calendar.calendar(year,w=2,l=1,c=6)は、複数行の文字列形式のyearカレンダーを返し、3ヶ月に1行、間隔距離cを返します.毎日の幅間隔はw文字です.各行の長さは21*W+18+2*Cである.lは毎週の行数です.
2
calendar.firstweekday()は、現在の週の開始日の設定を返します.デフォルトでは、calendarモジュールを最初にロードしたときに0(月曜日)を返します.
3
calendar.isleap(year)は、閏年にTrueを返します.そうでなければfalseです.
4
calendar.leapdays(y 1,y 2)は、Y 1,Y 2の2年間の閏年総数を返します.
5
calendar.month(year,month,w=2,l=1)は、複数行の文字列形式のyear年month月カレンダー、2行のタイトル、1週間の行を返します.毎日の幅間隔はw文字です.各行の長さは7*w+6です.lは毎週の行数です.
6
calendar.monthcalendar(year,month)は、整数の単層ネストリストを返します.各サブリスト・マウントは、1週間を表す整数です.Year年month月以外の日付は0に設定します.範囲内の日は、その月の何日目から表示され、1から始まります.
7
calendar.monthrange(year,month)は2つの整数を返します.1つ目は月の曜日の日付コードで、2つ目は月の日付コードです.日は0(月)から6(日)までです.月は1から12までです.
8
calendar.prcal(year,w=2,l=1,c=6)はprint calendarに相当する.calendar(year,w,l,c).
9
calendar.prmonth(year,month,w=2,l=1)はprint calendarに相当する.calendar(year,w,l,c).
10
calendar.setfirstweekday(weekday)は、毎週の開始日コードを設定します.0(月)から6(日)までです.
11
calendar.timegm(tupletime)とtime.gmtimeは逆に、時間メタグループ形式を受け入れ、その時刻を返す時間を中退する(1970紀元後に経過した浮動小数点秒数).
12
calendar.weekday(year,month,day)は、所定の日付の日付コードを返します.0(月)から6(日)までです.月は1(1月)から12(12月)です.
関連ドキュメント:
https://pymotw.com/3/calendar/index.html
https://www.imooc.com/wiki/detail/id/1911