网站建设实验报告格式,dede网站地图怎么做,买正品东西哪个网最好,电商网站开发过程calendar --- 日历相关函数
源代码#xff1a; Lib/calendar.py 这个模块让你可以输出像 Unix cal 那样的日历#xff0c;它还提供了其它与日历相关的实用函数。 默认情况下#xff0c;这些日历把星期一作为一周的第一天#xff0c;星期天作为一周的最后一天#xff08;这…calendar --- 日历相关函数
源代码 Lib/calendar.py 这个模块让你可以输出像 Unix cal 那样的日历它还提供了其它与日历相关的实用函数。 默认情况下这些日历把星期一作为一周的第一天星期天作为一周的最后一天这是欧洲惯例。可以使用 setfirstweekday() 方法设置一周的第一天为星期天 (6) 或者其它任意一天。函数全部接收整数类型的参数用来指定日期。其它相关功能参见 datetime 和 time 模块。
在这个模块中定义的函数和类都基于一个理想化的日历——向过去和未来两个方向无限扩展的现行公历。这与 Dershowitz 和 Reingold 的书“历法计算”中所有计算的基本日历 proleptic Gregorian 历的定义相符。0 和负数年份按照 ISO 8601 标准解释0 年指公元前 1 年-1 年指公元前 2 年依此类推。
class calendar.Calendar(firstweekday0)
创建一个 Calendar 对象。firstweekday 是一个用来指定每星期第一天的整数。MONDAY 是 0 默认值SUNDAY 是 6。
Calendar 对象提供了一些可用于对日历数据进行格式化的准备的方法。这个类本身不执行任何格式化操作。 这部分任务应由子类来完成。
Calendar 实例有下列方法
iterweekdays()
返回一个迭代器迭代器的内容为一周里每天的星期值。迭代器的第一个值与 firstweekday 属性的值一致。
itermonthdates(year, month)
为 year 年 month 月 (1-12) 返回一个迭代器。这个迭代器返回当月的所有日期使用 datetime.date 对象日期包含了本月头尾用于组成完整一周的日期。
itermonthdays(year, month)
为 year 年 month 月返回一个与 itermonthdates() 类似的迭代器但不会受 datetime.date 范围的限制。返回的为每一天的日期相对于当月 1 日过去的天数。对于不在当月的日期返回数字 0。
itermonthdays2(year, month)
为 year 年 month 月返回一个与 itermonthdates() 类似的迭代器但不会受 datetime.date 范围的限制。迭代器中的每一个元素为由日数和代表星期几的数字组成的元组。
itermonthdays3(year, month)
为 year 年 month 月返回一个与 itermonthdates() 类似的迭代器但不会受 datetime.date 范围的限制。迭代器的元素为一个由年、月、日组成的元组。
3.7 新版功能.
itermonthdays4(year, month)
为 year 年 month 月返回一个与 itermonthdates() 类似的迭代器但不会受 datetime.date 范围的限制。迭代器的元素为一个由年、月、日和代表星期几的数字组成的元组。
3.7 新版功能.
monthdatescalendar(year, month)
返回 year 年 month 月的周组成的列表。列表中的每一个周是由七个 datetime.date 对象组成的列表。
monthdays2calendar(year, month)
返回 year 年 month 月的周组成的列表。列表中的每一个周是七个由日数和代表星期几的数字组成的元组的列表。
monthdayscalendar(year, month)
返回 year 年 month 月的周组成的列表。列表中的每一个周是由七个日数组成的列表。
yeardatescalendar(year, width3)
返回可以用来格式化的指定年月的数据。返回的值是一个列表列表是月份组成的行。每一行包含了最多 width 个月(默认为3)。每个月包含了4到6周每周包含1--7天。每一天使用 datetime.date 对象。
yeardays2calendar(year, width3)
返回可以用来模式化的指定年月的数据(与 yeardatescalendar() 类似)。周列表的元素是由表示日期的数字和表示星期几的数字组成的元组。不在这个月的日子为0。
yeardayscalendar(year, width3)
返回可以用来模式化的指定年月的数据(与 yeardatescalendar() 类似)。周列表的元素是表示日期的数字。不在这个月的日子为0。
class calendar.TextCalendar(firstweekday0)
可以使用这个类生成纯文本日历。
TextCalendar 实例有以下方法
formatmonth(theyear, themonth, w0, l0)
返回指定月的用多行字符串表示的月历。w 为日期列的宽度日期列居中打印。l 指定了周与周之间的行距。返回的日历还依赖于构造器或者 setfirstweekday() 方法指定的每周的第一天是哪一天。
prmonth(theyear, themonth, w0, l0)
调用 formatmonth() 方法并打印返回的月历。
formatyear(theyear, w2, l1, c6, m3)
返回指定年的用多行字符串表示的 m 列年历。可选参数 w、l 和 c 分别表示日期列宽周的行距和月与月之间的纵向间隔。同样依赖于构造器或者 setfirstweekday() 方法指定的每周的第一天是哪一天。可以生成年历的最早的年是哪一年依赖于使用的平台。
pryear(theyear, w2, l1, c6, m3)
调用 formatyear() 方法并打印返回的年历。
class calendar.HTMLCalendar(firstweekday0)
可以使用这个类生成 HTML 日历。
HTMLCalendar 实例有以下方法
formatmonth(theyear, themonth, withyearTrue)
返回一个 HTML 表格作为指定年月的日历。 withyear 为真则年份将会包含在表头否则只显示月份。
formatyear(theyear, width3)
返回一个 HTML 表格作为指定年份的日历。 width (默认为3) 用于规定每一行显示月份的数量。
formatyearpage(theyear, width3, csscalendar.css, encodingNone)
返回一个完整的 HTML 页面作为指定年份的日历。 width*(默认为3) 用于规定每一行显示的月份数量。 *css 为层叠样式表的名字。如果不使用任何层叠样式表可以使用 None 。 encoding 为输出页面的编码 (默认为系统的默认编码)。
HTMLCalendar 有以下属性你可以重载它们来自定义应用日历的样式。
cssclasses
一个对应星期一到星期天的 CSS class 列表。默认列表为
cssclasses [mon, tue, wed, thu, fri, sat, sun]可以向每天加入其它样式
cssclasses [mon text-bold, tue, wed, thu, fri, sat, sun red]需要注意的是列表的长度必须为7。
cssclass_noday
工作日的 CSS 类在上个月或下个月发生。
3.7 新版功能.
cssclasses_weekday_head
用于标题行中的工作日名称的 CSS 类 列表。默认值与 cssclasses 相同。
3.7 新版功能.
cssclass_month_head
月份的头 CSS 类由 formatmonthname() 使用。默认值为 month 。
3.7 新版功能.
cssclass_month
某个月的月历的 CSS 类由 formatmonth() 使用。默认值为 month 。
3.7 新版功能.
cssclass_year
某年的年历的 CSS 类由 formatyear() 使用。默认值为 year 。
3.7 新版功能.
cssclass_year_head
年历的·表头 CSS 类由 formatyear() 使用。默认值为 year 。
3.7 新版功能.
需要注意的是尽管上面命名的样式类都是单独出现的(如 cssclass_month cssclass_noday), 但我们可以使用空格将样式类列表中的多个元素分隔开例如
text-bold text-red下面是一个如何自定义 HTMLCalendar 的示例
class CustomHTMLCal(calendar.HTMLCalendar):cssclasses [style text-nowrap for style incalendar.HTMLCalendar.cssclasses]cssclass_month_head text-center month-headcssclass_month text-center monthcssclass_year text-italic leadclass calendar.LocaleTextCalendar(firstweekday0, localeNone)
可以向这个 TextCalendar 的子类的构造器传入一个语言区域名称并将返回指定语言区域下的月份和星期名称。
class calendar.LocaleHTMLCalendar(firstweekday0, localeNone)
可以向这个 HTMLCalendar 的子类的构造器传入一个语言区域名称并将返回指定语言区域下的月份和星期名称。
备注 这个构造器、这两个类的 formatweekday() 和 formatmonthname() 方法会临时更改 LC_TIME 语言区域为给定的 locale。 因为当前语言区域是进程级的设置所以它们不是线程安全的。
这个模块为简单的文本日历提供了下列函数。
calendar.setfirstweekday(weekday)
设置每一周的开始0 表示星期一6 表示星期天。提供了 MONDAY、TUESDAY、WEDNESDAY、THURSDAY、FRIDAY、SATURDAY 和 SUNDAY 几个常量值作为方便。例如设置每周的第一天为星期天
import calendar
calendar.setfirstweekday(calendar.SUNDAY)calendar.firstweekday()
返回当前设置的每星期的第一天的数值。
calendar.isleap(year)
如果 year 是闰年则返回 True ,否则返回 False。
calendar.leapdays(y1, y2)
返回在范围 y1 至 y2 不包括 y2之间的闰年的年数其中 y1 和 y2 是年份。
此函数对于跨越世纪初的范围也适用。
calendar.weekday(year, month, day)
返回某年 1970 -- ...某月 1 -- 12 某日 1 -- 31 是星期几 0 是星期一。
calendar.weekheader(n)
返回一个包含星期几的缩写名的头。 n 指定星期几缩写的字符宽度。
calendar.monthrange(year, month)
返回指定 年份 的指定 月份 的第一天是星期几和这个月的天数。
calendar.monthcalendar(year, month)
返回表示一个月的日历的矩阵。 每一行代表一周此月份外的日子由零表示。 每周从周一开始除非使用 setfirstweekday() 改变设置。
calendar.prmonth(theyear, themonth, w0, l0)
打印由 month() 返回的一个月的日历。
calendar.month(theyear, themonth, w0, l0)
使用 TextCalendar 类的 formatmonth() 以多行字符串形式返回月份日历。
calendar.prcal(year, w0, l0, c6, m3)
打印由 calendar() 返回的整年的日历。
calendar.calendar(year, w2, l1, c6, m3)
使用 TextCalendar 类的 formatyear() 返回整年的3列的日历以多行字符串的形式。
calendar.timegm(tuple)
一个不相关但很好用的函数它接受一个时间元组例如 time 模块中的 gmtime() 函数的返回并返回相应的 Unix 时间戳值假定 1970 年开始计数 POSIX 编码。实际上 time.gmtime() 和 timegm() 是彼此相反的。
calendar 模块导出以下数据属性
calendar.day_name
在当前语言环境下表示星期几的数组。
calendar.day_abbr
在当前语言环境下表示星期几缩写的数组。
calendar.MONDAY
calendar.TUESDAY
calendar.WEDNESDAY
calendar.THURSDAY
calendar.FRIDAY
calendar.SATURDAY
calendar.SUNDAY
星期内每日序号的别名其中 MONDAY 是 0 而 SUNDAY 是 6。
3.12 新版功能.
class calendar.Day
将星期内的每一天定义为整数常量的枚举。 该枚举的成员以 MONDAY 至 SUNDAY 的形式导出到模块作用域。
3.12 新版功能.
calendar.month_name
在当前语言环境下表示一年中月份的数组。这遵循一月的月号为 1 的通常惯例所以它的长度为 13 且 month_name[0] 是空字符串。
calendar.month_abbr
在当前语言环境下表示月份简写的数组。这遵循一月的月号为 1 的通常惯例所以它的长度为 13 且 month_abbr[0] 是空字符串。
calendar.JANUARY
calendar.FEBRUARY
calendar.MARCH
calendar.APRIL
calendar.MAY
calendar.JUNE
calendar.JULY
calendar.AUGUST
calendar.SEPTEMBER
calendar.OCTOBER
calendar.NOVEMBER
calendar.DECEMBER
一年中各个月份的别名其中 JANUARY 是 1 而 DECEMBER 是 12。
3.12 新版功能.
class calendar.Month
将一年中各个月份定义为整数常量的枚举。 该枚举的成员以 JANUARY 至 DECEMBER 的形式导出到模块作用域。
3.12 新版功能.
calendar 模块定义了以下异常:
exception calendar.IllegalMonthError(month)
ValueError 的子类当给定的月份数字超出 1-12 范围不包括边界值时引发。
month
无效的月份数字。
exception calendar.IllegalWeekdayError(weekday)
ValueError 的子类当给定的星期数字超出 0-6 范围不包括边界值时引发。
weekday
无效的星期数字。
参见
模块 datetime
为日期和时间提供与 time 模块相似功能的面向对象接口。
模块 time
底层时间相关函数。
命令行用法
2.5 新版功能.
calendar 模块可以作为脚本从命令行执行以实现交互式地打印日历。
python -m calendar [-h] [-L LOCALE] [-e ENCODING] [-t {text,html}][-w WIDTH] [-l LINES] [-s SPACING] [-m MONTHS] [-c CSS][year] [month]例如打印 2000 年的日历
$ python -m calendar 20002000January February March
Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su1 2 1 2 3 4 5 6 1 2 3 4 53 4 5 6 7 8 9 7 8 9 10 11 12 13 6 7 8 9 10 11 12
10 11 12 13 14 15 16 14 15 16 17 18 19 20 13 14 15 16 17 18 19
17 18 19 20 21 22 23 21 22 23 24 25 26 27 20 21 22 23 24 25 26
24 25 26 27 28 29 30 28 29 27 28 29 30 31
31April May June
Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su1 2 1 2 3 4 5 6 7 1 2 3 43 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 30July August September
Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su1 2 1 2 3 4 5 6 1 2 33 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
31October November December
Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su1 1 2 3 4 5 1 2 32 3 4 5 6 7 8 6 7 8 9 10 11 12 4 5 6 7 8 9 109 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
30 31可以接受以下选项
--help, -h
显示帮助信息并退出。
--locale LOCALE, -L LOCALE
月份和星期名称所使用的语言区域。 默认为英语。
--encoding ENCODING, -e ENCODING
输出所使用的编码格式。 如果设置了 --locale 则 --encoding 将是必须的。
--type {text,html}, -t {text,html}
将日历以文本或 HTML 文档的形式打印到终端。
year
要打印日历的年份。 必须是 1 到 9999 之间的数字。 默认为当前年份。
month
指定 year 中要打印日历的月份。 必须是 1 到 12 之间的数字且只能在文本模式下使用。 默认打印全年的日历。
文本模式选项:
--width WIDTH, -w WIDTH
以终端的列数表示的日期列宽度。 日期将打印在列中央。 小于 2 的值将被忽略。 默认为 2。
--lines LINES, -l LINES
以终端的行数表示的每周的行数。 日期将顶端对齐打印。小于 1 的值将被忽略。 默认为 1。
--spacing SPACING, -s SPACING
列中的月份之间的空格。 小于 2 的值将被忽略。 默认为 6。
--months MONTHS, -m MONTHS
每行打印的月份数。 默认为 3。
HTML 模式选项:
--css CSS, -c CSS
日历要使用的 CSS 样式表的路径。 该路径必须是相对于所生成的 HTML或是一个绝对 HTTP 或 file:/// URL。
