💾 Archived View for tris.fyi › pydoc › calendar captured on 2023-04-26 at 13:27:23. Gemini links have been rewritten to link to archived content
⬅️ Previous capture (2023-01-29)
-=-=-=-=-=-=-
Calendar printing functions Note when comparing these calendars to the ones printed by cal(1): By default, these calendars have Monday as the first day of the week, and Sunday as the last (the European convention). Use setfirstweekday() to set the first day of the week (0=Monday, 6=Sunday).
Base calendar class. This class doesn't do any formatting. It simply
provides data to subclasses.
getfirstweekday(self)
itermonthdates(self, year, month)
Return an iterator for one month. The iterator will yield datetime.date
values and will always iterate through complete weeks, so it will yield
dates outside the specified month.
itermonthdays(self, year, month)
Like itermonthdates(), but will yield day numbers. For days outside
the specified month the day number is 0.
itermonthdays2(self, year, month)
Like itermonthdates(), but will yield (day number, weekday number)
tuples. For days outside the specified month the day number is 0.
itermonthdays3(self, year, month)
Like itermonthdates(), but will yield (year, month, day) tuples. Can be
used for dates outside of datetime.date range.
itermonthdays4(self, year, month)
Like itermonthdates(), but will yield (year, month, day, day_of_week) tuples.
Can be used for dates outside of datetime.date range.
iterweekdays(self)
Return an iterator for one week of weekday numbers starting with the
configured first one.
monthdatescalendar(self, year, month)
Return a matrix (list of lists) representing a month's calendar.
Each row represents a week; week entries are datetime.date values.
monthdays2calendar(self, year, month)
Return a matrix representing a month's calendar.
Each row represents a week; week entries are
(day number, weekday number) tuples. Day numbers outside this month
are zero.
monthdayscalendar(self, year, month)
Return a matrix representing a month's calendar.
Each row represents a week; days outside this month are zero.
setfirstweekday(self, firstweekday)
yeardatescalendar(self, year, width=3)
Return the data for the specified year ready for formatting. The return
value is a list of month rows. Each month row contains up to width months.
Each month contains between 4 and 6 weeks and each week contains 1-7
days. Days are datetime.date objects.
yeardays2calendar(self, year, width=3)
Return the data for the specified year ready for formatting (similar to
yeardatescalendar()). Entries in the week lists are
(day number, weekday number) tuples. Day numbers outside this month are
zero.
yeardayscalendar(self, year, width=3)
Return the data for the specified year ready for formatting (similar to
yeardatescalendar()). Entries in the week lists are day numbers.
Day numbers outside this month are zero.
firstweekday = <property object at 0x7f75e2e8ebb0>
This calendar returns complete HTML pages.
formatday(self, day, weekday)
Return a day as a table cell.
formatmonth(self, theyear, themonth, withyear=True)
Return a formatted month as a table.
formatmonthname(self, theyear, themonth, withyear=True)
Return a month name as a table row.
formatweek(self, theweek)
Return a complete week as a table row.
formatweekday(self, day)
Return a weekday name as a table header.
formatweekheader(self)
Return a header for a week as a table row.
formatyear(self, theyear, width=3)
Return a formatted year as a table of tables.
formatyearpage(self, theyear, width=3, css='calendar.css', encoding=None)
Return a formatted year as a complete HTML page.
getfirstweekday(self)
itermonthdates(self, year, month)
Return an iterator for one month. The iterator will yield datetime.date
values and will always iterate through complete weeks, so it will yield
dates outside the specified month.
itermonthdays(self, year, month)
Like itermonthdates(), but will yield day numbers. For days outside
the specified month the day number is 0.
itermonthdays2(self, year, month)
Like itermonthdates(), but will yield (day number, weekday number)
tuples. For days outside the specified month the day number is 0.
itermonthdays3(self, year, month)
Like itermonthdates(), but will yield (year, month, day) tuples. Can be
used for dates outside of datetime.date range.
itermonthdays4(self, year, month)
Like itermonthdates(), but will yield (year, month, day, day_of_week) tuples.
Can be used for dates outside of datetime.date range.
iterweekdays(self)
Return an iterator for one week of weekday numbers starting with the
configured first one.
monthdatescalendar(self, year, month)
Return a matrix (list of lists) representing a month's calendar.
Each row represents a week; week entries are datetime.date values.
monthdays2calendar(self, year, month)
Return a matrix representing a month's calendar.
Each row represents a week; week entries are
(day number, weekday number) tuples. Day numbers outside this month
are zero.
monthdayscalendar(self, year, month)
Return a matrix representing a month's calendar.
Each row represents a week; days outside this month are zero.
setfirstweekday(self, firstweekday)
yeardatescalendar(self, year, width=3)
Return the data for the specified year ready for formatting. The return
value is a list of month rows. Each month row contains up to width months.
Each month contains between 4 and 6 weeks and each week contains 1-7
days. Days are datetime.date objects.
yeardays2calendar(self, year, width=3)
Return the data for the specified year ready for formatting (similar to
yeardatescalendar()). Entries in the week lists are
(day number, weekday number) tuples. Day numbers outside this month are
zero.
yeardayscalendar(self, year, width=3)
Return the data for the specified year ready for formatting (similar to
yeardatescalendar()). Entries in the week lists are day numbers.
Day numbers outside this month are zero.
cssclass_month = 'month'
cssclass_month_head = 'month'
cssclass_noday = 'noday'
cssclass_year = 'year'
cssclass_year_head = 'year'
cssclasses = ['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun']
cssclasses_weekday_head = ['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun']
firstweekday = <property object at 0x7f75e2e8ebb0>
with_traceback(...)
Exception.with_traceback(tb) --
set self.__traceback__ to tb and return self.
args = <attribute 'args' of 'BaseException' objects>
with_traceback(...)
Exception.with_traceback(tb) --
set self.__traceback__ to tb and return self.
args = <attribute 'args' of 'BaseException' objects>
This class can be passed a locale name in the constructor and will return
month and weekday names in the specified locale. If this locale includes
an encoding all strings containing month and weekday names will be returned
as unicode.
formatday(self, day, weekday)
Return a day as a table cell.
formatmonth(self, theyear, themonth, withyear=True)
Return a formatted month as a table.
formatmonthname(self, theyear, themonth, withyear=True)
formatweek(self, theweek)
Return a complete week as a table row.
formatweekday(self, day)
formatweekheader(self)
Return a header for a week as a table row.
formatyear(self, theyear, width=3)
Return a formatted year as a table of tables.
formatyearpage(self, theyear, width=3, css='calendar.css', encoding=None)
Return a formatted year as a complete HTML page.
getfirstweekday(self)
itermonthdates(self, year, month)
Return an iterator for one month. The iterator will yield datetime.date
values and will always iterate through complete weeks, so it will yield
dates outside the specified month.
itermonthdays(self, year, month)
Like itermonthdates(), but will yield day numbers. For days outside
the specified month the day number is 0.
itermonthdays2(self, year, month)
Like itermonthdates(), but will yield (day number, weekday number)
tuples. For days outside the specified month the day number is 0.
itermonthdays3(self, year, month)
Like itermonthdates(), but will yield (year, month, day) tuples. Can be
used for dates outside of datetime.date range.
itermonthdays4(self, year, month)
Like itermonthdates(), but will yield (year, month, day, day_of_week) tuples.
Can be used for dates outside of datetime.date range.
iterweekdays(self)
Return an iterator for one week of weekday numbers starting with the
configured first one.
monthdatescalendar(self, year, month)
Return a matrix (list of lists) representing a month's calendar.
Each row represents a week; week entries are datetime.date values.
monthdays2calendar(self, year, month)
Return a matrix representing a month's calendar.
Each row represents a week; week entries are
(day number, weekday number) tuples. Day numbers outside this month
are zero.
monthdayscalendar(self, year, month)
Return a matrix representing a month's calendar.
Each row represents a week; days outside this month are zero.
setfirstweekday(self, firstweekday)
yeardatescalendar(self, year, width=3)
Return the data for the specified year ready for formatting. The return
value is a list of month rows. Each month row contains up to width months.
Each month contains between 4 and 6 weeks and each week contains 1-7
days. Days are datetime.date objects.
yeardays2calendar(self, year, width=3)
Return the data for the specified year ready for formatting (similar to
yeardatescalendar()). Entries in the week lists are
(day number, weekday number) tuples. Day numbers outside this month are
zero.
yeardayscalendar(self, year, width=3)
Return the data for the specified year ready for formatting (similar to
yeardatescalendar()). Entries in the week lists are day numbers.
Day numbers outside this month are zero.
cssclass_month = 'month'
cssclass_month_head = 'month'
cssclass_noday = 'noday'
cssclass_year = 'year'
cssclass_year_head = 'year'
cssclasses = ['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun']
cssclasses_weekday_head = ['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun']
firstweekday = <property object at 0x7f75e2e8ebb0>
This class can be passed a locale name in the constructor and will return
month and weekday names in the specified locale. If this locale includes
an encoding all strings containing month and weekday names will be returned
as unicode.
formatday(self, day, weekday, width)
Returns a formatted day.
formatmonth(self, theyear, themonth, w=0, l=0)
Return a month's calendar string (multi-line).
formatmonthname(self, theyear, themonth, width, withyear=True)
formatweek(self, theweek, width)
Returns a single week in a string (no newline).
formatweekday(self, day, width)
formatweekheader(self, width)
Return a header for a week.
formatyear(self, theyear, w=2, l=1, c=6, m=3)
Returns a year's calendar as a multi-line string.
getfirstweekday(self)
itermonthdates(self, year, month)
Return an iterator for one month. The iterator will yield datetime.date
values and will always iterate through complete weeks, so it will yield
dates outside the specified month.
itermonthdays(self, year, month)
Like itermonthdates(), but will yield day numbers. For days outside
the specified month the day number is 0.
itermonthdays2(self, year, month)
Like itermonthdates(), but will yield (day number, weekday number)
tuples. For days outside the specified month the day number is 0.
itermonthdays3(self, year, month)
Like itermonthdates(), but will yield (year, month, day) tuples. Can be
used for dates outside of datetime.date range.
itermonthdays4(self, year, month)
Like itermonthdates(), but will yield (year, month, day, day_of_week) tuples.
Can be used for dates outside of datetime.date range.
iterweekdays(self)
Return an iterator for one week of weekday numbers starting with the
configured first one.
monthdatescalendar(self, year, month)
Return a matrix (list of lists) representing a month's calendar.
Each row represents a week; week entries are datetime.date values.
monthdays2calendar(self, year, month)
Return a matrix representing a month's calendar.
Each row represents a week; week entries are
(day number, weekday number) tuples. Day numbers outside this month
are zero.
monthdayscalendar(self, year, month)
Return a matrix representing a month's calendar.
Each row represents a week; days outside this month are zero.
prmonth(self, theyear, themonth, w=0, l=0)
Print a month's calendar.
prweek(self, theweek, width)
Print a single week (no newline).
pryear(self, theyear, w=0, l=0, c=6, m=3) Print a year's calendar.
setfirstweekday(self, firstweekday)
yeardatescalendar(self, year, width=3)
Return the data for the specified year ready for formatting. The return
value is a list of month rows. Each month row contains up to width months.
Each month contains between 4 and 6 weeks and each week contains 1-7
days. Days are datetime.date objects.
yeardays2calendar(self, year, width=3)
Return the data for the specified year ready for formatting (similar to
yeardatescalendar()). Entries in the week lists are
(day number, weekday number) tuples. Day numbers outside this month are
zero.
yeardayscalendar(self, year, width=3)
Return the data for the specified year ready for formatting (similar to
yeardatescalendar()). Entries in the week lists are day numbers.
Day numbers outside this month are zero.
firstweekday = <property object at 0x7f75e2e8ebb0>
Subclass of Calendar that outputs a calendar as a simple plain text
similar to the UNIX program cal.
formatday(self, day, weekday, width)
Returns a formatted day.
formatmonth(self, theyear, themonth, w=0, l=0)
Return a month's calendar string (multi-line).
formatmonthname(self, theyear, themonth, width, withyear=True)
Return a formatted month name.
formatweek(self, theweek, width)
Returns a single week in a string (no newline).
formatweekday(self, day, width)
Returns a formatted week day name.
formatweekheader(self, width)
Return a header for a week.
formatyear(self, theyear, w=2, l=1, c=6, m=3)
Returns a year's calendar as a multi-line string.
getfirstweekday(self)
itermonthdates(self, year, month)
Return an iterator for one month. The iterator will yield datetime.date
values and will always iterate through complete weeks, so it will yield
dates outside the specified month.
itermonthdays(self, year, month)
Like itermonthdates(), but will yield day numbers. For days outside
the specified month the day number is 0.
itermonthdays2(self, year, month)
Like itermonthdates(), but will yield (day number, weekday number)
tuples. For days outside the specified month the day number is 0.
itermonthdays3(self, year, month)
Like itermonthdates(), but will yield (year, month, day) tuples. Can be
used for dates outside of datetime.date range.
itermonthdays4(self, year, month)
Like itermonthdates(), but will yield (year, month, day, day_of_week) tuples.
Can be used for dates outside of datetime.date range.
iterweekdays(self)
Return an iterator for one week of weekday numbers starting with the
configured first one.
monthdatescalendar(self, year, month)
Return a matrix (list of lists) representing a month's calendar.
Each row represents a week; week entries are datetime.date values.
monthdays2calendar(self, year, month)
Return a matrix representing a month's calendar.
Each row represents a week; week entries are
(day number, weekday number) tuples. Day numbers outside this month
are zero.
monthdayscalendar(self, year, month)
Return a matrix representing a month's calendar.
Each row represents a week; days outside this month are zero.
prmonth(self, theyear, themonth, w=0, l=0)
Print a month's calendar.
prweek(self, theweek, width)
Print a single week (no newline).
pryear(self, theyear, w=0, l=0, c=6, m=3) Print a year's calendar.
setfirstweekday(self, firstweekday)
yeardatescalendar(self, year, width=3)
Return the data for the specified year ready for formatting. The return
value is a list of month rows. Each month row contains up to width months.
Each month contains between 4 and 6 weeks and each week contains 1-7
days. Days are datetime.date objects.
yeardays2calendar(self, year, width=3)
Return the data for the specified year ready for formatting (similar to
yeardatescalendar()). Entries in the week lists are
(day number, weekday number) tuples. Day numbers outside this month are
zero.
yeardayscalendar(self, year, width=3)
Return the data for the specified year ready for formatting (similar to
yeardatescalendar()). Entries in the week lists are day numbers.
Day numbers outside this month are zero.
firstweekday = <property object at 0x7f75e2e8ebb0>
Inappropriate argument value (of correct type).
with_traceback(...)
Exception.with_traceback(tb) --
set self.__traceback__ to tb and return self.
args = <attribute 'args' of 'BaseException' objects>
repeat(object [,times]) -> create an iterator which returns the object for the specified number of times. If not specified, returns the object endlessly.
formatyear(theyear, w=2, l=1, c=6, m=3)
Returns a year's calendar as a multi-line string.
getfirstweekday()
format(cols, colwidth=20, spacing=6) Prints multi-column formatting for year calendars
formatstring(cols, colwidth=20, spacing=6) Returns a string formatted from n strings, centered within n columns.
isleap(year) Return True for leap years, False for non-leap years.
leapdays(y1, y2)
Return number of leap years in range [y1, y2).
Assume y1 <= y2.
main(args)
formatmonth(theyear, themonth, w=0, l=0)
Return a month's calendar string (multi-line).
monthdayscalendar(year, month)
Return a matrix representing a month's calendar.
Each row represents a week; days outside this month are zero.
monthrange(year, month)
Return weekday (0-6 ~ Mon-Sun) and number of days (28-31) for
year, month.
pryear(theyear, w=0, l=0, c=6, m=3) Print a year's calendar.
prmonth(theyear, themonth, w=0, l=0)
Print a month's calendar.
prweek(theweek, width)
Print a single week (no newline).
setfirstweekday(firstweekday)
timegm(tuple) Unrelated but handy function to calculate Unix timestamp from GMT.
formatweek(theweek, width)
Returns a single week in a string (no newline).
weekday(year, month, day) Return weekday (0-6 ~ Mon-Sun) for year, month (1-12), day (1-31).
formatweekheader(width)
Return a header for a week.
EPOCH = 1970
FRIDAY = 4
February = 2
January = 1
MONDAY = 0
SATURDAY = 5
SUNDAY = 6
THURSDAY = 3
TUESDAY = 1
WEDNESDAY = 2
c = <calendar.TextCalendar object at 0x7f75e2e90d90>
day_abbr = <calendar._localized_day object at 0x7f75e2e90160>
day_name = <calendar._localized_day object at 0x7f75e2e5b0a0>
mdays = [0, 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31]
month_abbr = <calendar._localized_month object at 0x7f75e2e90c70>
month_name = <calendar._localized_month object at 0x7f75e2e90a60>