Python3標准庫：calendar處理日期

1. calendar處理日期

calendar模塊第一了Calendar類，其中封裝了一些值的計算，如給定的一個月或一年中的周日期。另外，TextCalendar和HTMLCalendar類可以生成經過預格式化的輸出。

1.1 格式化示例

prmonth()方法是一個簡單的函數，可以生成月的格式化文本輸出。

import calendar

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

這個例子按照美國的慣例，將TextCalendar配置為一周從星期日開始。而默認則會使用歐洲慣例，即一周從星期一開始。這個例子會生成以下輸出。

利用HTMLCalendar和formatmonth()可以生成一個類似的HTML表格。顯示的輸出看起來與純文本的版本大致是一樣的，不過會用HTML標記包圍。各個表單元格有一個類屬性對應星期幾，從而可以通過CSS制定HTML的樣式。 

除了可用的默認格式外，要想以其他的某種格式生成輸出，可以使用calendar計算日期，並把這些值組織為周和月區間，然后迭代處理結果。對於這個任務，Calendar的weekheader()、monthcalendar()和yeardays2calendar()方法尤其有用。

調用yeardays2calendar()會生成一個由"月行"列表構成的序列。每個月列表包含一些月，每個月是一個周列表。周是元組列表，元組則由日編號(1~31)是星期幾編號(0~6)構成。當月以外的日編號為0。

import calendar
import pprint

cal = calendar.Calendar(calendar.SUNDAY)

cal_data = cal.yeardays2calendar(2020, 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)

調用yeardays2calendar(2020,3)會返回2020年的數據，按每行3個月組織。

這等價於formatyear()使用的數據。 

import calendar

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

如果給定相同的參數，則formatyear()會生成以下輸出。

1.2 本地化環境

如果不是為了當前本地化環境，而是要為另外一個本地化環境生成一個格式化的日歷，那么可以使用LocaleTextCalendar或LocaleHTMLCalendar。

import calendar

c = calendar.LocaleTextCalendar(locale='en_US')
c.prmonth(2020, 2)

print()

c = calendar.LocaleTextCalendar(locale='fr_FR')
c.prmonth(2020, 3)

一周的第一天不屬於本地化環境的設置。這個值取自calendar類的參數，常規的TextCalendar類也是如此。

1.3 計算日期

盡管calendar模塊主要強調采用不同格式打印完整的日歷，但它還是提供了另外一些函數，對采用其他方式處理日期很有用，如為一個重復事件計算日期。例如，Python Atlanta用戶組每月的第二個星期四召開一次會議。要計算一年中的會議日期，可以使用monthcalendar()的返回值。

import calendar
import pprint

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

有些日期的值為0。這說明這幾天對應的星期幾盡管在給定的當前月份里，但它們實際上屬於另一個月。

一周中的第一天默認為星期一。可以通過調用setfirstweekday()來改變這個設置，不過由於calendar模塊包含了一些常量來索引monthcalendar()返回的日期區間，所以在這種情況下更方便的做法是跳過這一步。

要計算一年的會議日期，假設是每個月的第二個星期四，那么可以查看monthcalendar()的輸出，找到星期四對應的日期。一個月的第一周和最后一周都要填充0值作為占位符，分別表示相應日期實際上在前一個月或下一個月。例如，如果一個月從星期五開始，那么第一周星期四位置上的值就是0。