{"id":6158,"date":"2022-06-10T18:40:54","date_gmt":"2022-06-10T16:40:54","guid":{"rendered":"http:\/\/miro.borodziuk.eu\/?p=6158"},"modified":"2026-01-15T10:05:31","modified_gmt":"2026-01-15T09:05:31","slug":"the-calendar-module-in-python","status":"publish","type":"post","link":"http:\/\/miro.borodziuk.eu\/index.php\/2022\/06\/10\/the-calendar-module-in-python\/","title":{"rendered":"The calendar module in Python"},"content":{"rendered":"

In addition to the datetime<\/code> and time<\/code> modules, the Python standard library provides a module called calendar<\/code> which, as the name suggests, offers calendar-related functions<\/b>.\u00a0One of them is of course displaying the calendar.<\/p>\n

<\/p>\n

1. In the calendar<\/code> <\/strong>module, the days of the week are displayed from Monday to Sunday. Each day of the week has its representation in the form of an integer, where the first day of the week (Monday) is represented by the value 0, while the last day of the week (Sunday) is represented by the value 6.<\/p>\n

 <\/p>\n

2. To display a calendar for any year, call the calendar()<\/code> <\/strong>function with the year passed as its argument, e.g.:<\/p>\n

import calendar\r\nprint(calendar.calendar(2020))<\/pre>\n
Note: A good alternative to the above function is the function called prcal()<\/code><\/strong>, which also takes the same parameters as the calendar()<\/code> <\/strong>function, but doesn’t require the use of the print<\/code> function to display the calendar.<\/p>\n
import calendar\r\ncalendar.prcal(2020)<\/pre>\n
 <\/p>\n
3. To display a calendar for any month of the year, call the month()<\/strong><\/code> function, passing year and month to it.\u00a0 For example:<\/p>\n
import calendar\r\nprint(calendar.month(2020, 9))\r\n\r\n<\/pre>\n
Note: You can also use the prmonth()<\/strong><\/code> function, which has the same parameters as the month()<\/code> <\/strong>function, but doesn’t require the use of the print<\/code> function to display the calendar.<\/p>\n
 <\/p>\n
4. The setfirstweekday()<\/code> <\/strong>function allows you to change the first day of the week. It takes a value from 0 to 6, where 0 is Sunday and 6 is Saturday.<\/p>\n
import calendar\r\n\r\ncalendar.setfirstweekday(calendar.SUNDAY)\r\ncalendar.prmonth(2020, 12)<\/pre>\n
 <\/p>\n
5. The result of the weekday()<\/code> <\/strong>function is a day of the week as an integer value for a given year, month, and day:<\/p>\n
import calendar\r\nprint(calendar.weekday(2020, 9, 29)) \r\n# This displays 1, which means Tuesday.<\/pre>\n
 <\/p>\n
6. The weekheader()<\/code> <\/strong>function returns the weekday names in a shortened form. The weekheader()<\/code> <\/strong>method requires you to specify the width in characters for one day of the week. If the width you provide is greater than 3, you’ll still get the abbreviated weekday names consisting of only three characters. For example:<\/p>\n
import calendar\r\nprint(calendar.weekheader(2)) \r\n# This display: Mo Tu We Th Fr Sa Su\r\n<\/pre>\n
 <\/p>\n
7.\u00a0The calendar<\/code> module provides two useful functions to check whether years are leap years. The first one, called isleap()<\/code><\/strong>, returns True<\/i> if the passed year is leap, or False<\/i> otherwise. The second one, called leapdays()<\/code><\/strong>, returns the number of leap years in the given range of years.<\/p>\n
\"\"<\/p>\n
import calendar\r\n\r\nprint(calendar.isleap(2020))\r\nprint(calendar.leapdays(2010, 2021))  # Up to but not including 2021.\r\n<\/pre>\n
True<\/code>
\n3<\/code><\/p>\n
 <\/p>\n
8. Classes for creating calendars:<\/p>\n