class calendar.Calendar(firstweekday=0)
创建一个 Calendar 对象。 firstweekday 是一个整数,用于指定一周的第一天。 0 是星期一(默认值),6 是星期天。
Calendar 对象提供了一些可被用于准备日历数据格式化的方法。 这个类本身不执行任何格式化操作。 这部分任务应由子类来完成。
Calendar 类的实例有下列方法:
iterweekdays()
返回一个迭代器,迭代器的内容为一星期的数字。迭代器的第一个值与 firstweekday 属性的值一致。
itermonthdates(year, month)
返回一个迭代器,迭代器的内容为 year 年 month 月(1-12)的日期。
这个迭代器返回当月的所有日期 ( datetime.date 对象),日期包含了本月头尾用于组成完整一周的日期。
itermonthdays2(year, month)
返回与itermonthdates()类似的迭代器。返回的天是一个元组,其中包含天的编号和周的编号。
itermonthdays(year, month)
返回与itermonthdates()类似的迭代器。返回的天数就是天数。
monthdatescalendar(year, month)
返回一个表示指定年月的周列表。周列表由七个 datetime.date 对象组成。
monthdays2calendar(year, month)
返回一个表示指定年月的周列表。周列表由七个代表日期的数字和代表周几的数字组成的二元元组。
monthdayscalendar(year, month)
返回一个表示指定年月的周列表。周列表由七个代表日期的数字组成。
yeardatescalendar(year, width=3)
返回可以用来格式化的指定年月的数据。返回的值是一个列表,列表是月份组成的行。
每一行包含了最多 width 个月(默认为3)。每个月包含了4到6周,每周包含1–7天。每一天使用 datetime.date 对象。
yeardays2calendar(year, width=3)
返回可以用来模式化的指定年月的数据(与 yeardatescalendar() 类似)。
周列表的元素是由表示日期的数字和表示星期几的数字组成的元组。不在这个月的日子为0。
yeardayscalendar(year, width=3)
返回可以用来模式化的指定年月的数据(与 yeardatescalendar() 类似)。周列表的元素是表示日期的数字。不在这个月的日子为0。
class calendar.TextCalendar(firstweekday=0)
可以使用这个类生成纯文本日历。
TextCalendar 实例有以下方法:
formatmonth(theyear, themonth, w=0, l=0)
返回一个多行字符串来表示指定年月的日历。w 为日期的宽度,但始终保持日期居中。l 指定了每星期占用的行数。
以上这些还依赖于构造器或者setfirstweekday() 方法指定的周的第一天是哪一天。
prmonth(theyear, themonth, w=0, l=0)
与 formatmonth() 方法一样,返回一个月的日历。
formatyear(theyear, w=2, l=1, c=6, m=3)
返回一个多行字符串,这个字符串为一个 m 列日历。可选参数 w, l, 和 c 分别表示日期列数, 周的行数, 和月之间的间隔。
同样,以上这些还依赖于构造器或者 setfirstweekday() 指定哪一天为一周的第一天。日历的第一年由平台依赖于使用的平台。
pryear(theyear, w=2, l=1, c=6, m=3)
与 formatyear() 方法一样,返回一整年的日历。
class calendar.HTMLCalendar(firstweekday=0)
可以使用这个类生成 HTML 日历。
HTMLCalendar 实例有以下方法:
formatmonth(theyear, themonth, withyear=True)
返回一个 HTML 表格作为指定年月的日历。 withyear 为真,则年份将会包含在表头,否则只显示月份。
formatyear(theyear, width=3)
返回一个 HTML 表格作为指定年份的日历。 width (默认为3) 用于规定每一行显示月份的数量。
formatyearpage(theyear, width=3, css='calendar.css', encoding=None)
返回一个完整的 HTML 页面作为指定年份的日历。
width (默认为3) 用于规定每一行显示的月份数量。
css 为层叠样式表的名字。如果不使用任何层叠样式表,可以使用 None。
encoding 为输出页面的编码 (默认为系统的默认编码)。
class calendar.LocaleTextCalendar(firstweekday=0, locale=None)
这个子类 TextCalendar 可以在构造函数中传递一个语言环境名称,并且返回月份和星期几的名称在特定语言环境中。
如果此语言环境包含编码,则包含月份和工作日名称的所有字符串将作为 unicode 返回。
class calendar.LocaleHTMLCalendar(firstweekday=0, locale=None)
可以在构造函数中传递HTMLCalendar的这个子类的地区名称,并将返回指定地区的月份和工作日名称。
如果这个地区包含一个编码,那么所有包含月份和工作日名称的字符串都将以unicode的形式返回。