Python calendar日歷模塊的說明

calendar（日歷）模塊，默認每周第一天是星期一，最后一天是星期天。

函數及描述

1. calendar.calendar(year, w=2, l=1, c=6, m=3)

　　返回一個多行字符串格式的year年年歷。

2. calendar.firstweekday()

　　返回當前每周起始日期的設置。默認返回0，即星期一。

3. calendar.isleap(year)

　　閏年返回True，否則False。

4. calendar.leapdays(y1, y2)

　　返回y1到y2之間的閏年總數，包含y1，不包含y2。

5. calendar.month(year, month, w=2, l=1)

　　返回一個多行字符串格式的year年month月日歷。

6. calendar.monthcalendar(year,month)

　　返回一個整數的單層嵌套列表。每個子列表裝載一個星期。該月之外的日期都為0，該月之內的日期設為該日的日期，從1開始。

7. calendar.monthrange(year, month)

　　返回兩個整數組成的元組，第一個是該月的第一天是星期幾，第二個是該月的天數。（calendar.monthrange(year, month)： 
　　Returns weekday of first day of the month and number of days in month, for the specified year and month.——Python文檔） 
　　ps：此處計算星期幾是按照星期一為0計算。

8. calendar.prcal(year, w=2, l=1, c=6)

　　等於print calendar.calendar(year)

9. calendar.prmonth(year, month)

　　同上。

10. calendar.setfirstweekday(weekday)

　　設置每周起始日期碼。0（星期一）到6（星期日）

11. calendar.timegm(tupletime)

　　和time.gmtime相反，接收一個時間元組，返回該時刻的時間戳（計算機元年之后的秒數）

12. calendar.weekday(year, month, day)

　　返回給定日期的星期碼，0（星期一）到6（星期日）。

轉自：http://blog.csdn.net/jianxia1956/article/details/52724217

實例：

'''
class Calendar(object):
    """
    Base calendar class. This class doesn't do any formatting. It simply
    provides data to subclasses.
    """
    ................................................

class TextCalendar(Calendar):
    """
    Subclass of Calendar that outputs a calendar as a simple plain text
    similar to the UNIX program cal.
    """
    ................................................

class HTMLCalendar(Calendar):
    """
    This calendar returns complete HTML pages.
    """
    ................................................
'''

'''
calendar.setfirstweekday(weekday)
設置每周的起始日期碼。0（星期一）到6（星期日）。

calendar.firstweekday()
返回當前每周起始日期的設置。默認情況下，首次載入calendar模塊時返回0，即星期一。

'''
calendar.setfirstweekday(calendar.SUNDAY)
print(calendar.firstweekday())

'''
calendar.calendar(year,w=2,l=1,c=6)
返回一個多行字符串格式的year年年歷，3個月一行，間隔距離為c。
每日寬度間隔為w字符。
每行長度為21* W+18+2* C。l是每星期行數。
'''
c = calendar.calendar(2017)
# c = calendar.TextCalendar()
# c = calendar.HTMLCalendar()
print(c)

'''
calendar.isleap(year)
是閏年返回True，否則為false。
'''
print(calendar.isleap(2016))

'''
calendar.leapdays(y1,y2)
返回在Y1，Y2兩年之間的閏年總數。
'''
print(calendar.leapdays(2010, 2017))

'''
calendar.month(year,month,w=2,l=1)
返回一個多行字符串格式的year年month月日歷，兩行標題，一周一行。
每日寬度間隔為w字符。每行的長度為7* w+6。l是每星期的行數。
'''
m = calendar.month(2017, 7)
print(m)

'''
calendar.monthcalendar(year,month)
返回一個整數的單層嵌套列表。每個子列表裝載代表一個星期的整數。
Year年month月外的日期都設為0;范圍內的日子都由該月第幾日表示，從1開始。
'''
print(calendar.monthcalendar(2017, 7))

'''
calendar.monthrange(year,month)
返回兩個整數。第一個是該月的首日所在星期的日期碼(0~6)，第二個是該月的天數(28-31)。
'''
print(calendar.monthrange(2017, 7))

'''
calendar.timegm(tupletime)
和time.gmtime相反：接受一個時間元組形式，返回該時刻的時間輟（1970紀元后經過的浮點秒數）。
很多Python函數用一個元組裝起來的9組數字處理時間:
序號     字段    值
0    4位數年    2008
1    月    1 到 12
2    日    1到31
3    小時    0到23
4    分鍾    0到59
5    秒    0到61 (60或61 是閏秒)
6    一周的第幾日    0到6 (0是周一)
7    一年的第幾日    1到366 (儒略歷)
8    夏令時    -1, 0, 1, -1是決定是否為夏令時的旗幟

上述也就是struct_time元組。這種結構具有如下屬性：
序號    屬性    值
0    tm_year    2008
1    tm_mon    1 到 12
2    tm_mday    1 到 31
3    tm_hour    0 到 23
4    tm_min    0 到 59
5    tm_sec    0 到 61 (60或61 是閏秒)
6    tm_wday    0到6 (0是周一)
7    tm_yday    1 到 366(儒略歷)
8    tm_isdst    -1, 0, 1, -1是決定是否為夏令時的旗幟
'''
print(calendar.timegm((2017, 7, 24, 11, 19, 0, 0, 0, 0)))

'''
calendar.weekday(year,month,day)
返回給定日期的日期碼。0（星期一）到6（星期日）。月份為 1（一月） 到 12（12月）。
'''
print(calendar.weekday(2017, 7, 23))

輸出：

6
                                  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

True
2
     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

[[0, 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]]
(5, 31)
1500895140
6