Python标准库 - calendar

Python 的标准函数"calendar"提供处理日期相关的实用方法,同时也可以将日历输出成为常见的日历格式。

calendar 常用方法

下方列出几种 calendar 模块常用的方法 :

方法 参数 说明
Calendar()
创建一个 calendar 对象
TextCalendar()
创建一个可以打印出与使用的日历
HTMLCalendar()
创建一个包含 HTML 格式的日历
setfirstweekday() n 设置日历里,每个星期的第一天是星期几 ( 星期一为 0,星期天为 6 )
firstweekday()
返回每个星期第一天的数值
isleap() year 判断 year 年份是否为闰年,返回 True 或 False
leapdays() y1, y2 计算 y1 年到 y2 年之间共包含几个闰年
weekday() year, month, day 返回某年某月的某一天是星期几 ( 星期一是 0 )
weekheader() n 返回星期几的开头缩写,n 的范围是 1~3
monthrange() year, month 返回某年某月的第一天是星期几 ( 星期一为 0 ),以及这个月的天数
monthcalendar() year, month 返回一个日历的二维列表
month() year, month, w=0, l=0 返回一个格式化的月份字符串
prmonth() year, month, w=0, l=0 等同 print(calendar.month())
calendar() year, w=0, l=0, c=6, m=3 返回一个格式化后一整年的月历字符串
prcal() year, w=2, l=1, c=6, m=3 等同 print(calendar.calendar())
day_name、calendar.day_abbr
返回星期一到星期天的名称或缩写
month_name、calendar.month_abbr
返回 1~12 月的名称或缩写

import calendar

要使用 calendar 必须先 import calendar 模块,或使用 from 的方式,单独 import 特定的类型。

javascript 复制代码
import calendar
from calendar import prmonth

Calendar()

calendar.Calendar() 可以创建一个 calendar 对象,calendar 对象可以使用下列几种方法:

方法 说明
iterweekdays() 产生一星期 0~6 的迭代对象
itermonthdates(year, month) 产生某年某月的迭代对象,如果该月份不是从星期一开始,会自动上前一个月的后几天,datetime.date
itermonthdays(year, month) 产生一个月份的迭代对象,格式为 0~6,如果该月份不是从星期一开始,会自动补 0
itermonthdays2(year, month) 产生一个月份的迭代对象,格式为 (0,0)~(31,6),如果该月份不是从星期一开始,会自动补 0
monthdatescalendar(year, month) 产生一个月份的二维列表,每个子列表由一周的七天组成,格式为 datetime.date
monthdayscalendar(year, month) 产生一个月份的二维列表,每个子列表由一周的七天组成,格式为 0~6
monthdays2calendar(year, month) 产生一个月份的二维列表,每个子列表由一周的七天组成,格式为 (0,0)~(31,6)
yeardatescalendar(year) 产生一整年的多维列表,每个子列表由一周的七天组成,格式为 datetime.date
yeardays2calendar(year) 产生一整年的多维列表,每个子列表由一周的七天组成,格式为 0~6
yeardayscalendar(year) 产生一整年的多维列表,每个子列表由一周的七天组成,格式为 (0,0)~(31,6)
erlang 复制代码
import calendar
c = calendar.Calendar()
print(list(c.iterweekdays()))
#[0, 1, 2, 3, 4, 5, 6]
print(list(c.itermonthdates(2021,10)))
# [datetime.date(2021, 9, 27), datetime.date(2021, 9, 28)....
print(list(c.itermonthdays(2021,10)))
# [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]
print(list(c.itermonthdays2(2021,10)))
# [(0, 0), (0, 1), (0, 2), (0, 3), (1, 4), (2, 5).....
print(c.monthdatescalendar(2021,10))
# [[datetime.date(2021, 9, 27), datetime.date(2021, 9, 28).....
print(c.monthdayscalendar(2021,10))
# [[0, 0, 0, 0, 1, 2, 3], [4, 5, 6, 7, 8, 9, 10]......
print(c.monthdays2calendar(2021,10))
# [[(0, 0), (0, 1), (0, 2), (0, 3), (1, 4), (2, 5).....
print(c.yeardatescalendar(2021))
# [[[[datetime.date(2020, 12, 28), datetime.date(2020, 12, 29)....
print(c.yeardayscalendar(2021))
# [[[[0, 0, 0, 0, 1, 2, 3], [4, 5, 6, 7, 8, 9, 10]....
print(c.yeardays2calendar(2021))
# [[[[(0, 0), (0, 1), (0, 2), (0, 3), (1, 4), (2, 5)....

TextCalendar()

calendar.TextCalendar() 可以创建一个可以打印出与使用的日历,有下列几种方法:

方法 说明
formatmonth(year, month, w=0, l=0) 产生格式化后一个月份的日历,w 和 l 是显示的宽高 ( 可不填 )
prmonth(year, month, w=0, l=0) 等同 print(formatmonth)
formatyear(year, month, w=0, l=0, c=6, m=3) 产生格式化后一个年份的月历,w 和 l 是显示的宽高 ( 可不填 ),c 和 m 表示是垂直和水平显示的列与栏 ( 可不填 )
pryear(year, month, w=0, l=0, c=6, m=3) 等同 print(formatyear)
python 复制代码
import calendar
tc = calendar.TextCalendar()
print(tc.formatmonth(2021,10))
tc.prmonth(2021,10)
'''
    October 2021
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
'''
print(tc.formatyear(2021, c=3, m=4))
tc.pryear(2021, c=3, m=4)
'''
                                           2021
      January                February                March                  April
Mo Tu We Th Fr Sa Su   Mo Tu We Th Fr Sa Su   Mo Tu We Th Fr Sa Su   Mo Tu We Th Fr Sa Su
             1  2  3    1  2  3  4  5  6  7    1  2  3  4  5  6  7             1  2  3  4
 4  5  6  7  8  9 10    8  9 10 11 12 13 14    8  9 10 11 12 13 14    5  6  7  8  9 10 11
11 12 13 14 15 16 17   15 16 17 18 19 20 21   15 16 17 18 19 20 21   12 13 14 15 16 17 18
18 19 20 21 22 23 24   22 23 24 25 26 27 28   22 23 24 25 26 27 28   19 20 21 22 23 24 25
25 26 27 28 29 30 31                          29 30 31               26 27 28 29 30
        May                    June                   July                  August
Mo Tu We Th Fr Sa Su   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  4                      1
 3  4  5  6  7  8  9    7  8  9 10 11 12 13    5  6  7  8  9 10 11    2  3  4  5  6  7  8
10 11 12 13 14 15 16   14 15 16 17 18 19 20   12 13 14 15 16 17 18    9 10 11 12 13 14 15
17 18 19 20 21 22 23   21 22 23 24 25 26 27   19 20 21 22 23 24 25   16 17 18 19 20 21 22
24 25 26 27 28 29 30   28 29 30               26 27 28 29 30 31      23 24 25 26 27 28 29
31                                                                   30 31
    September               October                November               December
Mo Tu We Th Fr Sa Su   Mo Tu We Th Fr Sa Su   Mo Tu We Th Fr Sa Su   Mo Tu We Th Fr Sa Su
       1  2  3  4  5                1  2  3    1  2  3  4  5  6  7          1  2  3  4  5
 6  7  8  9 10 11 12    4  5  6  7  8  9 10    8  9 10 11 12 13 14    6  7  8  9 10 11 12
13 14 15 16 17 18 19   11 12 13 14 15 16 17   15 16 17 18 19 20 21   13 14 15 16 17 18 19
20 21 22 23 24 25 26   18 19 20 21 22 23 24   22 23 24 25 26 27 28   20 21 22 23 24 25 26
27 28 29 30            25 26 27 28 29 30 31   29 30                  27 28 29 30 31
'''

HTMLCalendar()

calendar.HTMLCalendar() 可以创建一个包含 HTML 格式的日历,,有下列几种方法:

方法 说明
formatmonth(year, month, withyear=True) 输出某年里某个月份的日历 HTML 表格,withyear 默认 True 表示显示年份 ( 可不填 )
formatmonth(year, width=3) 输出某年的月历 HTML 表格,width 表示一行里有几个月,默认 3 ( 可不填 )
formatyearpage(year, width=3, css='xxx.css', encoding=None) 输出某年的月历 HTML 网页代码,width 表示一行里有几个月,默认 3 ( width、css、encoding 都可不填 )
go 复制代码
import calendar
html = calendar.HTMLCalendar()
print(html.formatmonth(2021,10))
# 示例网页:https://jsbin.com/jilexovube/1/edit?html,css,output
ini 复制代码
import calendar
html = calendar.HTMLCalendar()
print(html.formatyear(2021, width=4))
print(html.formatyearpage(2021, width=4))
# 示例网址:https://jsbin.com/nawepogoti/1/edit?html,css,output

setfirstweekday(n)

calendar.setfirstweekday(n) 可以设置日历里,每个星期的第一天是星期几 ( 星期一为 0,星期天为 6 ),只要是日期对象都可以使用 setfirstweekday 方法设置,例如下方的程序,执行后会将星期五变成日历的第一天。

python 复制代码
import calendar
tc = calendar.TextCalendar()
tc.setfirstweekday(4)    # 设置星期五为第一天
tc.prmonth(2021,10)
'''
    October 2021
Fr Sa Su Mo Tu We Th
 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
'''

firstweekday()

calendar.firstweekday() 使用后会返回每个星期第一天的数值,如果设置为 0,就会返回 0。

python 复制代码
import calendar
calendar.setfirstweekday(0)
print(calendar.firstweekday())   # 0

isleap(year)

calendar.isleap(year) 可以判断某一年是否为闰年,返回 True 或 False。

python 复制代码
import calendar
print(calendar.isleap(2020))   # True
print(calendar.isleap(2021))   # False
print(calendar.isleap(2022))   # False

leapdays(y1, y2)

calendar.leapdays(y1, y2) 可以计算 y1 年到 y2 年之间共包含几个闰年。

python 复制代码
import calendar
print(calendar.leapdays(1920, 2020))   # 25 ( 1920~2020 年间,有 25 个闰年 )

weekday(year, month, day)

calendar.weekday(year, month, day) 可以返回某年某月的某一天是星期几 ( 星期一从 0 开始 )。

python 复制代码
import calendar
print(calendar.weekday(2021,10,1))   # 4 ( 2021/10/1 是星期五 )

weekheader(n)

calendar.weekheader(n) 可以返回星期几的开头缩写,n 的范围是 1~3。

python 复制代码
import calendar
print(calendar.weekheader(1))   # M T W T F S S
print(calendar.weekheader(2))   # Mo Tu We Th Fr Sa Su
print(calendar.weekheader(3))   # Mon Tue Wed Thu Fri Sat Sun

monthrange(year, month)

calendar.monthrange(year, month) 可以返回某年某月的第一天是星期几 ( 星期一为 0 ),以及这个月的天数。

scss 复制代码
import calendar
print(calendar.monthrange(2021,10))
# (4, 31)  2021 的 10 月有 31 天,10 月第一天是星期五
print(calendar.monthrange(2021,11))   # (0, 30)
# (0, 30)  2021 的 11 月有 30 天,11 月第一天是星期一

monthcalendar(year, month)

calendar.monthcalendar(year, month) 可以返回一个日历的二维列表。

scss 复制代码
import calendar
print(calendar.monthcalendar(2021,10))
# [[0, 0, 0, 0, 1, 2, 3], [4, 5, 6, 7, 8, 9, 10], [11, 12, 13, 14, 15, 16, 17]...

month(year, month, w=0, l=0)

calendar.month(year, month, w=0, l=0) 可以返回一个格式化的月份字符串,效果和 formatmonth 相同。

python 复制代码
import calendar
calendar.setfirstweekday(6)    # 设置第一天是星期天
print(calendar.month(2021, 10))
'''
    October 2021
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
'''

prmonth(year, month, w=0, l=0)

效果等同 " print(calendar.month(year, month, w=0, l=0))"。

calendar(year, w=0, l=0, c=6, m=3)

效果等同 " formatyear(year, month, w=0, l=0, c=6, m=3)"。

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

效果等同 " print(calendar.calendar(year, w=0, l=0, c=6, m=3))"。

day_name, calendar.day_abbr

calendar.day_name、calendar.day_abbr 使用后会返回星期一到星期天的名称或缩写。

scss 复制代码
import calendar
print(list(calendar.day_name))
# ['Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday']
print(list(calendar.day_abbr))
# ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']

month_name, calendar.month_abbr

calendar.month_name、calendar.month_abbr 使用后会返回 1~12 月的名称或缩写 ( 产生后的第一个值会是空值 )。

scss 复制代码
import calendar
print(list(calendar.month_name))
# ['', 'January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December']
print(list(calendar.month_abbr))
# ['', 'Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']
相关推荐
岁月宁静9 分钟前
从零拆解 AI 语音模拟面试系统
人工智能·python·agent
benchmark_cc15 分钟前
个人开发者接入五档盘口:用 QuantDash 读取单只股票的验收清单与易错点
python·数据分析·pandas·量化交易·股票数据·quantdash
ZhengEnCi2 小时前
项目越写越乱?先别改架构:用一次目录重排 + 一份可复算的体检脚本把乱治住
python·架构·ai编程
考虑考虑2 小时前
nginx拦截url
运维·后端·nginx
Dmz丶2 小时前
前端转 AI 100 天 Day 45:阶段复盘——从“会调 API”到“做出 AI 产品”
python
GISer_Jing2 小时前
GitHub热点I
后端·ai·langchain
Sakura_j_h_3 小时前
MCP SDK 2.0 实战:用 MCPServer 搭本地笔记检索服务
开发语言·笔记·python·qt·ai工具·mcp·mcpserver
谭光志3 小时前
如何让 AI 高效工作
前端·后端·ai编程
ServBay3 小时前
连AI自己也不愿意维护自己的屎山代码
后端·ai编程·claude
QuZhengRong3 小时前
【AI】Agent 全栈进阶|AgentScope 沙箱源码解析
python·学习·ai·agent·沙箱