calendar 模块

calendar模块，即日历模块，提供了对日期的一些操作方法，和生成日历的方法

注：星期一是默认的每周第一天，星期天是默认的最后一天。更改设置需调用calendar.setfirstweekday()函数

导入calendar 模块

import calendar
import time

# calendar.calendar(year,w=2,l=1,c=6)
# 返回一个多行字符串格式的year年年历，3个月一行，间隔距离为c。 每日宽度间隔为w字符。每行长度为21* W+18+2* C。l是每星期行数

c0 = calendar.calendar(2017)     # 返回一年的日历

                                  2017
# 
#       January                   February                   March
# Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su
#                    1             1  2  3  4  5             1  2  3  4  5
#  2  3  4  5  6  7  8       6  7  8  9 10 11 12       6  7  8  9 10 11 12
#  9 10 11 12 13 14 15      13 14 15 16 17 18 19      13 14 15 16 17 18 19
# 16 17 18 19 20 21 22      20 21 22 23 24 25 26      20 21 22 23 24 25 26
# 23 24 25 26 27 28 29      27 28                     27 28 29 30 31
# 30 31
# 
#        April                      May                       June
# Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su
#                 1  2       1  2  3  4  5  6  7                1  2  3  4
#  3  4  5  6  7  8  9       8  9 10 11 12 13 14       5  6  7  8  9 10 11
# 10 11 12 13 14 15 16      15 16 17 18 19 20 21      12 13 14 15 16 17 18
# 17 18 19 20 21 22 23      22 23 24 25 26 27 28      19 20 21 22 23 24 25
# 24 25 26 27 28 29 30      29 30 31                  26 27 28 29 30
# 
#         July                     August                  September
# Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su
#                 1  2          1  2  3  4  5  6                   1  2  3
#  3  4  5  6  7  8  9       7  8  9 10 11 12 13       4  5  6  7  8  9 10
# 10 11 12 13 14 15 16      14 15 16 17 18 19 20      11 12 13 14 15 16 17
# 17 18 19 20 21 22 23      21 22 23 24 25 26 27      18 19 20 21 22 23 24
# 24 25 26 27 28 29 30      28 29 30 31               25 26 27 28 29 30
# 31
# 
#       October                   November                  December
# Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su      Mo Tu We Th Fr Sa Su
#                    1             1  2  3  4  5                   1  2  3
#  2  3  4  5  6  7  8       6  7  8  9 10 11 12       4  5  6  7  8  9 10
#  9 10 11 12 13 14 15      13 14 15 16 17 18 19      11 12 13 14 15 16 17
# 16 17 18 19 20 21 22      20 21 22 23 24 25 26      18 19 20 21 22 23 24
# 23 24 25 26 27 28 29      27 28 29 30               25 26 27 28 29 30 31

c1 = calendar.HTMLCalendar(calendar.MONDAY)
print (c1)
# <calendar.HTMLCalendar object at 0x0000000002F86908>  # HTMLCalendar可以在构造函数中通过语言环境名称,将返回月和工作日的名称在指定的场所

calendar.month(year,month,w=2,l=1)
返回一个多行字符串格式的year年month月日历，两行标题，一周一行。每日宽度间隔为w字符。每行的长度为7* w+6。l是每星期的行数

c2 = calendar.month(2017,4)   # 返回某个月的日历
print (c2)

#      April 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

calendar.isleap()   # 是闰年返回True，否则为false

c3 = calendar.isleap(2017)
print (c3)
# False

calendar.leapdays(y1,y2) 返回在Y1，Y2两年之间的闰年总数

c4 = calendar.leapdays(2000,2017)
print (c4)
# 5

calendar.monthcalendar(year,month)
# 返回一个整数的单层嵌套列表。每个子列表装载代表一个星期的整数。Year年month月外的日期都设为0;范围内的日子都由该月第几日表示，从1开始

c5 = calendar.monthcalendar(2017,4)
print (c5)

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

calendar.monthrange(year,month)
# 返回两个整数。第一个是该月的星期几的日期码，第二个是该月的日期码.(返回月的第一天工作日天数和月)

c6 = calendar.monthrange(2017,4)
print (c6)

# (5, 30)

　　

calendar.firstweekday( )
# 返回当前每周起始日期的设置。默认情况下，首次载入caendar模块时返回0，即星期一

c7 = calendar.firstweekday()
print (c7)
# 0

calendar.setfirstweekday(weekday)
# 设置每周的起始日期码。0（星期一）到6（星期日）

calendar.setfirstweekday(calendar.SUNDAY)  # 将起始日设置为星期日
print (calendar.firstweekday())
# 6

日历（Calendar）模块 的函数使用和描述

"""
序号 函数及描述
1  calendar.calendar(year,w=2,l=1,c=6)   返回一个多行字符串格式的year年年历，3个月一行，间隔距离为c。 每日宽度间隔为w字符。每行长度为21* W+18+2* C。l是每星期行数。
2  calendar.firstweekday( )              返回当前每周起始日期的设置。默认情况下，首次载入caendar模块时返回0，即星期一。
3  calendar.isleap(year)                 是闰年返回True，否则为false。
4  calendar.leapdays(y1,y2)              返回在Y1，Y2两年之间的闰年总数。
5  calendar.month(year,month,w=2,l=1)    返回一个多行字符串格式的year年month月日历，两行标题，一周一行。每日宽度间隔为w字符。每行的长度为7* w+6。l是每星期的行数。
6  calendar.monthcalendar(year,month)    返回一个整数的单层嵌套列表。每个子列表装载代表一个星期的整数。Year年month月外的日期都设为0;范围内的日子都由该月第几日表示，从1开始。
7  calendar.monthrange(year,month)       返回两个整数。第一个是该月的星期几的日期码，第二个是该月的日期码。日从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（一月） 到 12（12月）
"""

# 参考：https://docs.python.org/3/library/calendar.html