30.5. calendar - функции для работы с календарем 419

misc header

Заголовок к списку доступных тем помощи, не являющихся командами (то есть, для которых есть метод help *(), но нет соответствующего метода do *()).

undoc header

Заголовок к списку недокументированных команд (для которых есть соответствующий метод do *(), но нет метода help *()).

ruler

Символ, который используется для линий под заголовком помощи. Если является пустой строкой, линия не будет использована. По умолчанию атрибут ruler равен

30.5 calendar - функции для работы с календарем

Этот модуль предоставляет функции для работы с календарем, а также позволяет выводить календарь аналогично программе cal. По умолчанию считается, что неделя начинается с понедельника. Чтобы установить иной день, например воскресенье, используйте функцию setfirstweekday() .

MONDAY

TUESDAY

WEDNESDAY

THURSDAY

FRIDAY

SATURDAY SUNDAY

Константы со значениями от 0 (понедельник) до 6 (воскресенье), представляющие дни недели.

setfirstweekday(weekday)

Устанавливает использование weekday (целое число от 0 до 6) в качестве первого дня недели. Например, следующий фрагмент устанавливает использование в качестве первого дня недели воскресенья:

import calendar

calendar.setfirstweekday(calendar.SUNDAY) firstweekday()

Возвращает целое число от 0 до 6, определяющее день недели, с которого (согласно текущим установкам) неделя начинается.

isleap( year)

Возвращает 1 , если год year (целое число) является високосным, иначе возвращает 0 .

monthrange(year, month)

Возвращает кортеж, содержащий первый день недели месяца (целое число от 0 до 6) и число дней в месяце для указанного года (аргумент year) и месяца (аргумент month).

monthcalendar( year, month)

Возвращает матрицу (список списков), представляющую календарь на месяц для указанного года (аргумент year) и месяца (аргумент month). Каждый элемент возвращаемого списка представляет собой список из семи элементов - чисел для каждого дня недели. Дни, выходящие за пределы месяца, представлены нулями. Неделя начинается с понедельника, если иной день не был установлен с помощью функции setfirstweekday() .

month( theyear, themonth [, datewidth [, linesperweek]])

Возвращает строковое представление календаря на месяц для указанного года (аргумент theyear) и месяца (аргумент themonth). Аргументы datewidth и linesperweek определяют ширину поля даты и число строк, используемых для одной недели.

prmonth( theyear, themonth [, datewidth [, linesperweek]])

Выводит на стандартный поток вывода (sys.stdout) календарь на месяц. Аргументы имеют такое же значение, как и для функции month() .

calendar( year [, datewidth [, linesperweek [, spaces]]])

Возвращает строковое представление в три колонки календаря на год year. Аргументы datewidth, linesperweek и spaces определяют ширину поля даты, число строк, используемых для одной недели, и количество пробелов между колонками с календарями на месяц.

prcal()

Выводит на стандартный поток вывода (sys.stdout) календарь на год. Аргументы имеют такое же значение, как и для функции calendar() .

leapdays(yl, у2)

Возвращает число високосных лет в промежутке с у1 по у2 - 1 год (включительно).

weekday(year, month, day)

Возвращает целое число, определяющее день недели для указанной даты. year - год (см. замечания в описании модуля time), month - месяц (от 1 до 12) и day - число (от 1 до 31). Например, следующий код позволяет вывести номера месяцев 2000 года, в которых 13 число приходится на пятницу:

>>> from calendar import weekday, FRIDAY >>> for month in xrange(1, 13): ... if weekday(2000, month, 13)==FRIDAY:

... print month

30.5. calendar - функции для работы с календарем 421

timegm (time tuple)

Возвращает число секунд, прошедших с начала эпохи (независимо от системы начало эпохи считается равным началу 1970 года) до времени, которое представлено кортежем из девяти чисел time tuple (см. описание модуля time).