`calendar.md`

205 строк · 19.1 КБ · обычная страница · сырой текст · скачать
1> **Источник:** https://python-all.ru/3.6/library/calendar.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 8.2. [`calendar`](https://python-all.ru/3.6/library/calendar.html#module-calendar) – Общие функции для работы с календарем89**Исходный код:** [Lib/calendar.py](https://python-all.ru/src/3.6/Lib/calendar.py)1011---1213Этот модуль позволяет выводить календари, как программа Unix **cal**, и предоставляет дополнительные полезные функции, связанные с календарём. По умолчанию в этих календарях первый день недели – понедельник, а последний – воскресенье (европейская конвенция). Используйте [`setfirstweekday()`](https://python-all.ru/3.6/library/calendar.html#calendar.setfirstweekday), чтобы установить первый день недели на воскресенье (6) или любой другой день недели. Параметры, задающие даты, передаются в виде целых чисел. За дополнительными возможностями обращайтесь также к модулям [`datetime`](https://python-all.ru/3.6/library/datetime.html#module-datetime) и [`time`](https://python-all.ru/3.6/library/time.html#module-time).1415Большинство этих функций и классов полагаются на модуль [`datetime`](https://python-all.ru/3.6/library/datetime.html#module-datetime), который использует идеализированный календарь – современный григорианский календарь, расширенный в обоих направлениях. Это соответствует определению «пролептического григорианского» календаря из книги Дершовица и Рейнгольда «Calendrical Calculations», где он является базовым календарем для всех вычислений.1617#### `class calendar.Calendar(firstweekday=0)`1819Создаёт объект [`Calendar`](https://python-all.ru/3.6/library/calendar.html#calendar.Calendar). *firstweekday* – целое число, указывающее первый день недели. `0` – понедельник (по умолчанию), `6` – воскресенье.2021Объект [`Calendar`](https://python-all.ru/3.6/library/calendar.html#calendar.Calendar) предоставляет несколько методов, которые можно использовать для подготовки данных календаря к форматированию. Этот класс сам не выполняет форматирование – это задача подклассов.2223Экземпляры [`Calendar`](https://python-all.ru/3.6/library/calendar.html#calendar.Calendar) имеют следующие методы:2425#### `iterweekdays()`2627Возвращает итератор по номерам дней недели, которые будут использоваться в течение одной недели. Первое значение из итератора будет совпадать со значением свойства [`firstweekday`](https://python-all.ru/3.6/library/calendar.html#calendar.firstweekday).2829#### `itermonthdates(year, month)`3031Возвращает итератор для месяца *month* (1–12) года *year*. Этот итератор вернёт все дни (в виде объектов [`datetime.date`](https://python-all.ru/3.6/library/datetime.html#datetime.date)) за месяц, а также все дни до начала месяца или после его окончания, необходимые для получения полной недели.3233#### `itermonthdays2(year, month)`3435Возвращает итератор для месяца *month* в году *year*, аналогично [`itermonthdates()`](https://python-all.ru/3.6/library/calendar.html#calendar.Calendar.itermonthdates). Возвращаемые дни представляют собой кортежи, состоящие из номера дня и номера дня недели.3637#### `itermonthdays(year, month)`3839Возвращает итератор для месяца *month* в году *year*, аналогично [`itermonthdates()`](https://python-all.ru/3.6/library/calendar.html#calendar.Calendar.itermonthdates). Возвращаемые дни – это просто номера дней.4041#### `monthdatescalendar(year, month)`4243Возвращает список недель в месяце *month* года *year* в виде полных недель. Каждая неделя – список из семи объектов [`datetime.date`](https://python-all.ru/3.6/library/datetime.html#datetime.date).4445#### `monthdays2calendar(year, month)`4647Возвращает список недель в месяце *month* года *year* в виде полных недель. Каждая неделя – это список из семи кортежей с номером дня и номером дня недели.4849#### `monthdayscalendar(year, month)`5051Возвращает список недель в месяце *month* года *year* в виде полных недель. Каждая неделя – это список из семи номеров дней.5253#### `yeardatescalendar(year, width=3)`5455Возвращает данные для указанного года, готовые к форматированию. Возвращаемое значение – это список строк месяцев. Каждая строка месяца содержит до *width* месяцев (по умолчанию 3). Каждый месяц содержит от 4 до 6 недель, а каждая неделя – от 1 до 7 дней. Дни представлены объектами [`datetime.date`](https://python-all.ru/3.6/library/datetime.html#datetime.date).5657#### `yeardays2calendar(year, width=3)`5859Возвращает данные для указанного года, готовые к форматированию (аналогично [`yeardatescalendar()`](https://python-all.ru/3.6/library/calendar.html#calendar.Calendar.yeardatescalendar)). Записи в списках недель – это кортежи из номера дня и номера дня недели. Номера дней за пределами этого месяца равны нулю.6061#### `yeardayscalendar(year, width=3)`6263Возвращает данные для указанного года, готовые к форматированию (аналогично [`yeardatescalendar()`](https://python-all.ru/3.6/library/calendar.html#calendar.Calendar.yeardatescalendar)). Записи в списках недель – это номера дней. Номера дней за пределами этого месяца равны нулю.6465#### `class calendar.TextCalendar(firstweekday=0)`6667Этот класс можно использовать для создания текстовых календарей.6869Экземпляры [`TextCalendar`](https://python-all.ru/3.6/library/calendar.html#calendar.TextCalendar) имеют следующие методы:7071#### `formatmonth(theyear, themonth, w=0, l=0)`7273Возвращает календарь месяца в виде многострочной строки. Если указан параметр *w*, он задаёт ширину столбцов с датами, которые центрируются. Если указан параметр *l*, он задаёт количество строк, которое будет занимать каждая неделя. Зависит от первого дня недели, указанного в конструкторе или заданного методом [`setfirstweekday()`](https://python-all.ru/3.6/library/calendar.html#calendar.setfirstweekday).7475#### `prmonth(theyear, themonth, w=0, l=0)`7677Печатает календарь месяца, возвращаемый функцией [`formatmonth()`](https://python-all.ru/3.6/library/calendar.html#calendar.TextCalendar.formatmonth).7879#### `formatyear(theyear, w=2, l=1, c=6, m=3)`8081Возвращает календарь на весь год с *m* столбцами в виде многострочной строки. Необязательные параметры *w*, *l* и *c* задают ширину столбца даты, количество строк на неделю и количество пробелов между столбцами месяцев соответственно. Зависит от первого дня недели, указанного в конструкторе или заданного методом [`setfirstweekday()`](https://python-all.ru/3.6/library/calendar.html#calendar.setfirstweekday). Самый ранний год, для которого можно сгенерировать календарь, зависит от платформы.8283#### `pryear(theyear, w=2, l=1, c=6, m=3)`8485Печатает календарь на весь год, возвращаемый функцией [`formatyear()`](https://python-all.ru/3.6/library/calendar.html#calendar.TextCalendar.formatyear).8687#### `class calendar.HTMLCalendar(firstweekday=0)`8889Этот класс можно использовать для создания HTML-календарей.9091Экземпляры [`HTMLCalendar`](https://python-all.ru/3.6/library/calendar.html#calendar.HTMLCalendar) имеют следующие методы:9293#### `formatmonth(theyear, themonth, withyear=True)`9495Возвращает календарь месяца в виде HTML-таблицы. Если *withyear* равен true, год будет включен в заголовок, иначе будет использовано только название месяца.9697#### `formatyear(theyear, width=3)`9899Возвращает календарь года в виде HTML-таблицы. *width* (по умолчанию 3) задает количество месяцев в строке.100101#### `formatyearpage(theyear, width=3, css='calendar.css', encoding=None)`102103Возвращает календарь года в виде полной HTML-страницы. *width* (по умолчанию 3) задает количество месяцев в строке. *css* – это имя используемой каскадной таблицы стилей. [`None`](https://python-all.ru/3.6/library/constants.html#None) можно передать, если таблица стилей не нужна. *encoding* задает кодировку для вывода (по умолчанию используется системная кодировка).104105#### `class calendar.LocaleTextCalendar(firstweekday=0, locale=None)`106107Этот подкласс [`TextCalendar`](https://python-all.ru/3.6/library/calendar.html#calendar.TextCalendar) может принимать название локали в конструкторе и возвращать названия месяцев и дней недели в указанной локали. Если эта локаль включает кодировку, все строки, содержащие названия месяцев и дней недели, будут возвращены в виде Unicode.108109#### `class calendar.LocaleHTMLCalendar(firstweekday=0, locale=None)`110111Этот подкласс [`HTMLCalendar`](https://python-all.ru/3.6/library/calendar.html#calendar.HTMLCalendar) может принимать название локали в конструкторе и возвращать названия месяцев и дней недели в указанной локали. Если эта локаль включает кодировку, все строки, содержащие названия месяцев и дней недели, будут возвращены в виде Unicode.112113> **Примечание**114>115> Методы `formatweekday()` и `formatmonthname()` этих двух классов временно изменяют текущую локаль на указанную *locale*. Поскольку текущая локаль является общепроцессной настройкой, они не являются потокобезопасными.116117Для простых текстовых календарей этот модуль предоставляет следующие функции.118119#### `calendar.setfirstweekday(weekday)`120121Устанавливает день недели (`0` – понедельник, `6` – воскресенье), с которого начинается каждая неделя. Для удобства предоставлены значения `MONDAY`, `TUESDAY`, `WEDNESDAY`, `THURSDAY`, `FRIDAY`, `SATURDAY` и `SUNDAY`. Например, чтобы первым днём недели было воскресенье:122123```python124import calendar125calendar.setfirstweekday(calendar.SUNDAY)126```127128#### `calendar.firstweekday()`129130Возвращает текущую настройку дня недели, с которого начинается каждая неделя.131132#### `calendar.isleap(year)`133134Возвращает [`True`](https://python-all.ru/3.6/library/constants.html#True), если *year* – високосный год, иначе [`False`](https://python-all.ru/3.6/library/constants.html#False).135136#### `calendar.leapdays(y1, y2)`137138Возвращает количество високосных лет в диапазоне от *y1* до *y2* (не включая), где *y1* и *y2* – это годы.139140Эта функция работает для диапазонов, охватывающих смену столетий.141142#### `calendar.weekday(year, month, day)`143144Возвращает день недели (`0` – понедельник) для *year* (`1970`–…), *month* (`1`–`12`), *day* (`1`–`31`).145146#### `calendar.weekheader(n)`147148Возвращает заголовок, содержащий сокращённые названия дней недели. *n* задаёт ширину в символах для одного дня недели.149150#### `calendar.monthrange(year, month)`151152Возвращает день недели первого дня месяца и количество дней в месяце для указанных *year* и *month*.153154#### `calendar.monthcalendar(year, month)`155156Возвращает матрицу, представляющую календарь месяца. Каждая строка представляет неделю; дни вне месяца представлены нулями. Каждая неделя начинается с понедельника, если не задано иное с помощью [`setfirstweekday()`](https://python-all.ru/3.6/library/calendar.html#calendar.setfirstweekday).157158#### `calendar.prmonth(theyear, themonth, w=0, l=0)`159160Выводит календарь на месяц, возвращаемый функцией [`month()`](https://python-all.ru/3.6/library/calendar.html#calendar.month).161162#### `calendar.month(theyear, themonth, w=0, l=0)`163164Возвращает календарь на месяц в виде многострочной строки с помощью `formatmonth()` класса [`TextCalendar`](https://python-all.ru/3.6/library/calendar.html#calendar.TextCalendar).165166#### `calendar.prcal(year, w=0, l=0, c=6, m=3)`167168Выводит календарь на целый год, возвращаемый функцией [`calendar()`](https://python-all.ru/3.6/library/calendar.html#module-calendar).169170#### `calendar.calendar(year, w=2, l=1, c=6, m=3)`171172Возвращает календарь на целый год в три колонки в виде многострочной строки с помощью `formatyear()` класса [`TextCalendar`](https://python-all.ru/3.6/library/calendar.html#calendar.TextCalendar).173174#### `calendar.timegm(tuple)`175176Не связанная напрямую, но удобная функция, которая принимает кортеж времени, например возвращаемый функцией [`gmtime()`](https://python-all.ru/3.6/library/time.html#time.gmtime) из модуля [`time`](https://python-all.ru/3.6/library/time.html#module-time), и возвращает соответствующее значение метки времени Unix, предполагая эпоху 1970 года и кодировку POSIX. На самом деле, [`time.gmtime()`](https://python-all.ru/3.6/library/time.html#time.gmtime) и [`timegm()`](https://python-all.ru/3.6/library/calendar.html#calendar.timegm) являются обратными друг другу.177178Модуль [`calendar`](https://python-all.ru/3.6/library/calendar.html#module-calendar) экспортирует следующие атрибуты данных:179180#### `calendar.day_name`181182Массив, представляющий дни недели в текущей локали.183184#### `calendar.day_abbr`185186Массив, представляющий сокращённые названия дней недели в текущей локали.187188#### `calendar.month_name`189190Массив, представляющий месяцы года в текущей локали. Это соответствует общепринятому соглашению, по которому январь – месяц номер 1, поэтому длина массива равна 13, а `month_name[0]` – пустая строка.191192#### `calendar.month_abbr`193194Массив, представляющий сокращённые названия месяцев года в текущей локали. По общепринятому соглашению январь – месяц номер 1, поэтому он имеет длину 13, а `month_abbr[0]` – пустая строка.195196> **См. также**197>198> **Модуль [`datetime`](https://python-all.ru/3.6/library/datetime.html#module-datetime)**199>200> Объектно-ориентированный интерфейс для работы с датами и временем, предоставляющий функциональность, аналогичную модулю [`time`](https://python-all.ru/3.6/library/time.html#module-time).201>202> **Модуль [`time`](https://python-all.ru/3.6/library/time.html#module-time)**203>204> Низкоуровневые функции для работы со временем.205