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组数字处理时间:
序号     字段    值
   4位数年    2008
   月    1 到 12
   日    1到31
   小时    0到23
   分钟    0到59
   秒    0到61 (60或61 是闰秒)
   一周的第几日    0到6 (0是周一)
   一年的第几日    1到366 (儒略历)
   夏令时    -1, 0, 1, -1是决定是否为夏令时的旗帜

上述也就是struct_time元组。这种结构具有如下属性：
序号    属性    值
   tm_year    2008
   tm_mon    1 到 12
   tm_mday    1 到 31
   tm_hour    0 到 23
   tm_min    0 到 59
   tm_sec    0 到 61 (60或61 是闰秒)
   tm_wday    0到6 (0是周一)
   tm_yday    1 到 366(儒略历)
   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))

输出

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
 2  3  4  5  6  7                1  2  3  4                1  2  3  4
 9 10 11 12 13 14       5  6  7  8  9 10 11       5  6  7  8  9 10 11
16 17 18 19 20 21      12 13 14 15 16 17 18      12 13 14 15 16 17 18
23 24 25 26 27 28      19 20 21 22 23 24 25      19 20 21 22 23 24 25
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  2  3  4  5  6                   1  2  3
 3  4  5  6  7  8       7  8  9 10 11 12 13       4  5  6  7  8  9 10
10 11 12 13 14 15      14 15 16 17 18 19 20      11 12 13 14 15 16 17
17 18 19 20 21 22      21 22 23 24 25 26 27      18 19 20 21 22 23 24
24 25 26 27 28 29      28 29 30 31               25 26 27 28 29 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  2  3  4  5                      1  2
 3  4  5  6  7  8       6  7  8  9 10 11 12       3  4  5  6  7  8  9
10 11 12 13 14 15      13 14 15 16 17 18 19      10 11 12 13 14 15 16
17 18 19 20 21 22      20 21 22 23 24 25 26      17 18 19 20 21 22 23
24 25 26 27 28 29      27 28 29 30 31            24 25 26 27 28 29 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
 2  3  4  5  6  7                1  2  3  4                      1  2
 9 10 11 12 13 14       5  6  7  8  9 10 11       3  4  5  6  7  8  9
16 17 18 19 20 21      12 13 14 15 16 17 18      10 11 12 13 14 15 16
23 24 25 26 27 28      19 20 21 22 23 24 25      17 18 19 20 21 22 23
30 31                  26 27 28 29 30            24 25 26 27 28 29 30

True
     July 2017
Su Mo Tu We Th Fr Sa
 2  3  4  5  6  7  8
10 11 12 13 14 15
17 18 19 20 21 22
24 25 26 27 28 29
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)
6