`calendar.md`

225 строк · 19.4 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/2.7/library/calendar.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 8.2. [`calendar`](https://python-all.ru/2.7/library/calendar.html#module-calendar) – Общие функции для работы с календарем89**Исходный код:** [Lib/calendar.py](https://python-all.ru/src/2.7/Lib/calendar.py)1011---1213Этот модуль позволяет выводить календари, как программа Unix **cal**, и предоставляет дополнительные полезные функции, связанные с календарём. По умолчанию в этих календарях первый день недели – понедельник, а последний – воскресенье (европейская конвенция). Используйте [`setfirstweekday()`](https://python-all.ru/2.7/library/calendar.html#calendar.setfirstweekday), чтобы установить первый день недели на воскресенье (6) или любой другой день недели. Параметры, задающие даты, передаются в виде целых чисел. За дополнительными возможностями обращайтесь также к модулям [`datetime`](https://python-all.ru/2.7/library/datetime.html#module-datetime) и [`time`](https://python-all.ru/2.7/library/time.html#module-time).1415Большинство этих функций и классов опираются на модуль [`datetime`](https://python-all.ru/2.7/library/datetime.html#module-datetime), который использует идеализированный календарь, то есть текущий григорианский календарь, бесконечно продолженный в обе стороны. Это соответствует определению «пролептического григорианского» календаря в книге Дершовица и Рейнгольда «Calendrical Calculations», где он используется как базовый для всех вычислений.1617#### `class calendar.Calendar([firstweekday])`1819Создаёт объект [`Calendar`](https://python-all.ru/2.7/library/calendar.html#calendar.Calendar). *firstweekday* – целое число, указывающее первый день недели. `0` – понедельник (по умолчанию), `6` – воскресенье.2021Объект [`Calendar`](https://python-all.ru/2.7/library/calendar.html#calendar.Calendar) предоставляет несколько методов, которые можно использовать для подготовки данных календаря к форматированию. Этот класс сам не выполняет форматирование – это задача подклассов.2223Новое в версии 2.5.2425Экземпляры [`Calendar`](https://python-all.ru/2.7/library/calendar.html#calendar.Calendar) имеют следующие методы:2627#### `iterweekdays()`2829Возвращает итератор по номерам дней недели, которые будут использоваться в течение одной недели. Первое значение из итератора будет совпадать со значением свойства [`firstweekday`](https://python-all.ru/2.7/library/calendar.html#calendar.firstweekday).3031#### `itermonthdates(year, month)`3233Возвращает итератор для месяца *month* (1–12) года *year*. Этот итератор вернёт все дни (в виде объектов [`datetime.date`](https://python-all.ru/2.7/library/datetime.html#datetime.date)) за месяц, а также все дни до начала месяца или после его окончания, необходимые для получения полной недели.3435#### `itermonthdays2(year, month)`3637Возвращает итератор для месяца *month* в году *year*, аналогично [`itermonthdates()`](https://python-all.ru/2.7/library/calendar.html#calendar.Calendar.itermonthdates). Возвращаемые дни представляют собой кортежи, состоящие из номера дня и номера дня недели.3839#### `itermonthdays(year, month)`4041Возвращает итератор для месяца *month* в году *year*, аналогично [`itermonthdates()`](https://python-all.ru/2.7/library/calendar.html#calendar.Calendar.itermonthdates). Возвращаемые дни – это просто номера дней.4243#### `monthdatescalendar(year, month)`4445Возвращает список недель в месяце *month* года *year* в виде полных недель. Каждая неделя – список из семи объектов [`datetime.date`](https://python-all.ru/2.7/library/datetime.html#datetime.date).4647#### `monthdays2calendar(year, month)`4849Возвращает список недель в месяце *month* года *year* в виде полных недель. Каждая неделя – это список из семи кортежей с номером дня и номером дня недели.5051#### `monthdayscalendar(year, month)`5253Возвращает список недель в месяце *month* года *year* в виде полных недель. Каждая неделя – это список из семи номеров дней.5455#### `yeardatescalendar(year[, width])`5657Возвращает данные для указанного года, готовые к форматированию. Возвращаемое значение – это список строк месяцев. Каждая строка месяца содержит до *width* месяцев (по умолчанию 3). Каждый месяц содержит от 4 до 6 недель, а каждая неделя – от 1 до 7 дней. Дни представлены объектами [`datetime.date`](https://python-all.ru/2.7/library/datetime.html#datetime.date).5859#### `yeardays2calendar(year[, width])`6061Возвращает данные для указанного года, готовые к форматированию (аналогично [`yeardatescalendar()`](https://python-all.ru/2.7/library/calendar.html#calendar.Calendar.yeardatescalendar)). Записи в списках недель – это кортежи из номера дня и номера дня недели. Номера дней за пределами этого месяца равны нулю.6263#### `yeardayscalendar(year[, width])`6465Возвращает данные для указанного года, готовые к форматированию (аналогично [`yeardatescalendar()`](https://python-all.ru/2.7/library/calendar.html#calendar.Calendar.yeardatescalendar)). Записи в списках недель – это номера дней. Номера дней за пределами этого месяца равны нулю.6667#### `class calendar.TextCalendar([firstweekday])`6869Этот класс можно использовать для создания текстовых календарей.7071Новое в версии 2.5.7273Экземпляры [`TextCalendar`](https://python-all.ru/2.7/library/calendar.html#calendar.TextCalendar) имеют следующие методы:7475#### `formatmonth(theyear, themonth[, w[, l]])`7677Возвращает календарь месяца в виде многострочной строки. Если указан параметр *w*, он задаёт ширину столбцов с датами, которые центрируются. Если указан параметр *l*, он задаёт количество строк, которое будет занимать каждая неделя. Зависит от первого дня недели, указанного в конструкторе или заданного методом [`setfirstweekday()`](https://python-all.ru/2.7/library/calendar.html#calendar.setfirstweekday).7879#### `prmonth(theyear, themonth[, w[, l]])`8081Печатает календарь месяца, возвращаемый функцией [`formatmonth()`](https://python-all.ru/2.7/library/calendar.html#calendar.TextCalendar.formatmonth).8283#### `formatyear(theyear[, w[, l[, c[, m]]]])`8485Возвращает календарь на весь год с *m* столбцами в виде многострочной строки. Необязательные параметры *w*, *l* и *c* задают ширину столбца даты, количество строк на неделю и количество пробелов между столбцами месяцев соответственно. Зависит от первого дня недели, указанного в конструкторе или заданного методом [`setfirstweekday()`](https://python-all.ru/2.7/library/calendar.html#calendar.setfirstweekday). Самый ранний год, для которого можно сгенерировать календарь, зависит от платформы.8687#### `pryear(theyear[, w[, l[, c[, m]]]])`8889Печатает календарь на весь год, возвращаемый функцией [`formatyear()`](https://python-all.ru/2.7/library/calendar.html#calendar.TextCalendar.formatyear).9091#### `class calendar.HTMLCalendar([firstweekday])`9293Этот класс можно использовать для создания HTML-календарей.9495Новое в версии 2.5.9697Экземпляры [`HTMLCalendar`](https://python-all.ru/2.7/library/calendar.html#calendar.HTMLCalendar) имеют следующие методы:9899#### `formatmonth(theyear, themonth[, withyear])`100101Возвращает календарь месяца в виде HTML-таблицы. Если *withyear* равен true, год будет включен в заголовок, иначе будет использовано только название месяца.102103#### `formatyear(theyear[, width])`104105Возвращает календарь года в виде HTML-таблицы. *width* (по умолчанию 3) задает количество месяцев в строке.106107#### `formatyearpage(theyear[, width[, css[, encoding]]])`108109Возвращает календарь года в виде полной HTML-страницы. *width* (по умолчанию 3) задает количество месяцев в строке. *css* – это имя используемой каскадной таблицы стилей. [`None`](https://python-all.ru/2.7/library/constants.html#None) можно передать, если таблица стилей не нужна. *encoding* задает кодировку для вывода (по умолчанию используется системная кодировка).110111#### `class calendar.LocaleTextCalendar([firstweekday[, locale]])`112113Этот подкласс [`TextCalendar`](https://python-all.ru/2.7/library/calendar.html#calendar.TextCalendar) может принимать название локали в конструкторе и возвращать названия месяцев и дней недели в указанной локали. Если эта локаль включает кодировку, все строки, содержащие названия месяцев и дней недели, будут возвращены в виде Unicode.114115Новое в версии 2.5.116117#### `class calendar.LocaleHTMLCalendar([firstweekday[, locale]])`118119Этот подкласс [`HTMLCalendar`](https://python-all.ru/2.7/library/calendar.html#calendar.HTMLCalendar) может принимать название локали в конструкторе и возвращать названия месяцев и дней недели в указанной локали. Если эта локаль включает кодировку, все строки, содержащие названия месяцев и дней недели, будут возвращены в виде Unicode.120121Новое в версии 2.5.122123> **Примечание**124>125> Методы `formatweekday()` и `formatmonthname()` этих двух классов временно изменяют текущую локаль на указанную *locale*. Поскольку текущая локаль является общепроцессной настройкой, они не являются потокобезопасными.126127Для простых текстовых календарей этот модуль предоставляет следующие функции.128129#### `calendar.setfirstweekday(weekday)`130131Устанавливает день недели (`0` – понедельник, `6` – воскресенье), с которого начинается каждая неделя. Для удобства предоставлены значения `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY` и `SUNDAY`. Например, чтобы первым днём недели было воскресенье:132133```python134import calendar135calendar.setfirstweekday(calendar.SUNDAY)136```137138Новое в версии 2.0.139140#### `calendar.firstweekday()`141142Возвращает текущую настройку дня недели, с которого начинается каждая неделя.143144Новое в версии 2.0.145146#### `calendar.isleap(year)`147148Возвращает [`True`](https://python-all.ru/2.7/library/constants.html#True), если *year* – високосный год, иначе [`False`](https://python-all.ru/2.7/library/constants.html#False).149150#### `calendar.leapdays(y1, y2)`151152Возвращает количество високосных лет в диапазоне от *y1* до *y2* (не включая), где *y1* и *y2* – это годы.153154Изменено в версии 2.0: Эта функция не работала для диапазонов, охватывающих смену столетия в Python 1.5.2.155156#### `calendar.weekday(year, month, day)`157158Возвращает день недели (`0` – понедельник) для *year* (`1970`–…), *month* (`1`–`12`), *day* (`1`–`31`).159160#### `calendar.weekheader(n)`161162Возвращает заголовок, содержащий сокращённые названия дней недели. *n* задаёт ширину в символах для одного дня недели.163164#### `calendar.monthrange(year, month)`165166Возвращает день недели первого дня месяца и количество дней в месяце для указанных *year* и *month*.167168#### `calendar.monthcalendar(year, month)`169170Возвращает матрицу, представляющую календарь месяца. Каждая строка представляет неделю; дни вне месяца представлены нулями. Каждая неделя начинается с понедельника, если не задано иное с помощью [`setfirstweekday()`](https://python-all.ru/2.7/library/calendar.html#calendar.setfirstweekday).171172#### `calendar.prmonth(theyear, themonth[, w[, l]])`173174Выводит календарь на месяц, возвращаемый функцией [`month()`](https://python-all.ru/2.7/library/calendar.html#calendar.month).175176#### `calendar.month(theyear, themonth[, w[, l]])`177178Возвращает календарь на месяц в виде многострочной строки с помощью `formatmonth()` класса [`TextCalendar`](https://python-all.ru/2.7/library/calendar.html#calendar.TextCalendar).179180Новое в версии 2.0.181182#### `calendar.prcal(year[, w[, l[c]]])`183184Выводит календарь на целый год, возвращаемый функцией [`calendar()`](https://python-all.ru/2.7/library/calendar.html#module-calendar).185186#### `calendar.calendar(year[, w[, l[c]]])`187188Возвращает 3-колоночный календарь на целый год в виде многострочной строки, используя `formatyear()` класса [`TextCalendar`](https://python-all.ru/2.7/library/calendar.html#calendar.TextCalendar).189190Новое в версии 2.0.191192#### `calendar.timegm(tuple)`193194Не связанная напрямую, но удобная функция, которая принимает кортеж времени, например возвращаемый функцией [`gmtime()`](https://python-all.ru/2.7/library/time.html#time.gmtime) из модуля [`time`](https://python-all.ru/2.7/library/time.html#module-time), и возвращает соответствующее значение метки времени Unix, предполагая эпоху 1970 года и кодировку POSIX. На самом деле, [`time.gmtime()`](https://python-all.ru/2.7/library/time.html#time.gmtime) и [`timegm()`](https://python-all.ru/2.7/library/calendar.html#calendar.timegm) являются обратными друг другу.195196Новое в версии 2.0.197198Модуль [`calendar`](https://python-all.ru/2.7/library/calendar.html#module-calendar) экспортирует следующие атрибуты данных:199200#### `calendar.day_name`201202Массив, представляющий дни недели в текущей локали.203204#### `calendar.day_abbr`205206Массив, представляющий сокращённые названия дней недели в текущей локали.207208#### `calendar.month_name`209210Массив, представляющий месяцы года в текущей локали. Это соответствует общепринятому соглашению, по которому январь – месяц номер 1, поэтому длина массива равна 13, а `month_name[0]` – пустая строка.211212#### `calendar.month_abbr`213214Массив, представляющий сокращённые названия месяцев года в текущей локали. По общепринятому соглашению январь – месяц номер 1, поэтому он имеет длину 13, а `month_abbr[0]` – пустая строка.215216> **См. также**217>218> **Модуль [`datetime`](https://python-all.ru/2.7/library/datetime.html#module-datetime)**219>220> Объектно-ориентированный интерфейс для работы с датами и временем, предоставляющий функциональность, аналогичную модулю [`time`](https://python-all.ru/2.7/library/time.html#module-time).221>222> **Модуль [`time`](https://python-all.ru/2.7/library/time.html#module-time)**223>224> Низкоуровневые функции для работы со временем.225