Text of docs.python.org › uk › 3 › library › calendar.html as Styx crawled it on Nov 19, 2026. The page may have changed since. Only its words are kept, without pictures or layout, and only the first part of a long page.

Open the live page

calendar — General calendar-related functions — Python 3.15.2 documentation

Навігація індекс модулі | наступний | попередній | Python » 3.15.2 documentation » The Python standard library » Типи даних » calendar — General calendar-related functions | Theme | calendar — General calendar-related functions ¶ Вихідний код: Lib/calendar.py Цей модуль дозволяє виводити календарі, як програма Unix cal , і надає додаткові корисні функції, пов’язані з календарем.

За замовчуванням у цих календарях першим днем тижня є понеділок, а останнім — неділя (європейська конвенція). Використовуйте setfirstweekday() , щоб установити першим днем тижня неділю (6) або будь-який інший день тижня. Параметри, що визначають дати, задаються як цілі числа.

Для пов’язаних функцій перегляньте також модулі datetime і time . Функції та класи, визначені в цьому модулі, використовують ідеалізований календар, поточний григоріанський календар, розширений на невизначений термін в обох напрямках.

Це відповідає визначенню «пролептичного григоріанського» календаря в книзі Дершовіца та Рейнгольда «Календарні обчислення», де це базовий календар для всіх обчислень. Нульові та негативні роки інтерпретуються відповідно до стандарту ISO 8601.

Рік 0 — це 1 рік до нашої ери, рік -1 — це 2 рік до нашої ери і так далі. class calendar. Calendar ( firstweekday = 0 ) ¶ Створює об’єкт Calendar . firstweekday — це ціле число, що визначає перший день тижня. MONDAY — це 0 (за замовчуванням), SUNDAY — 6 . Об’єкт Calendar надає кілька методів, які можна використовувати для підготовки даних календаря до форматування.

Цей клас сам не виконує форматування. Це робота підкласів. Calendar instances have the following methods and attributes: firstweekday ¶ The first weekday as an integer (0–6). This property can also be set and read using setfirstweekday() and getfirstweekday() respectively. getfirstweekday ( ) ¶ Return an int for the current first weekday (0–6). Identical to reading the firstweekday property. setfirstweekday ( firstweekday ) ¶ Set the first weekday to firstweekday , passed as an int (0–6).

Identical to setting the firstweekday property. iterweekdays ( ) ¶ Return an iterator for the weekday numbers that will be used for one week. The first value from the iterator will be the same as the value of the firstweekday property. itermonthdates ( year , month ) ¶ Повертає ітератор для місяця month (1–12) у році year . Цей ітератор поверне всі дні (як об’єкти datetime.date ) за місяць і всі дні до початку або після кінця місяця, необхідні для отримання повного тижня. itermonthdays ( year , month ) ¶ Повертає ітератор для місяця місяць у році рік , подібний до itermonthdates() , але не обмежений діапазоном datetime.date .

Повернені дні будуть просто номерами днів місяця. Для днів поза вказаним місяцем номер дня дорівнює 0 . itermonthdays2 ( year , month ) ¶ Return an iterator for the month month in the year year similar to itermonthdates() , but not restricted by the datetime.date range. Days returned will be tuples consisting of a day of the month number and a weekday number. itermonthdays3 ( year , month ) ¶ Повертає ітератор для місяця місяць у році рік , подібний до itermonthdates() , але не обмежений діапазоном datetime.date .

Повернуті дні будуть кортежами, що складаються з номерів року, місяця та дня місяця. Added in version 3.7. itermonthdays4 ( year , month ) ¶ Повертає ітератор для місяця місяць у році рік , подібний до itermonthdates() , але не обмежений діапазоном datetime.date . Повернуті дні будуть кортежами, що складаються з номерів року, місяця, дня місяця та дня тижня.

Added in version 3.7. monthdatescalendar ( year , month ) ¶ Повертає список тижнів у місяці місяць року як повні тижні. Тижні — це списки із семи об’єктів datetime.date . monthdays2calendar ( year , month ) ¶ Повертає список тижнів у місяці місяць року як повні тижні. Тижні — це списки із семи кортежів номерів днів і днів тижня. monthdayscalendar ( year , month ) ¶ Повертає список тижнів у місяці місяць року як повні тижні.

Тижні — це списки із семи днів. yeardatescalendar ( year , width = 3 ) ¶ Повернути готові до форматування дані за вказаний рік. Поверненим значенням є список рядків місяця. Кожен рядок місяця містить до width місяців (за замовчуванням до 3). Кожен місяць містить від 4 до 6 тижнів, а кожен тиждень містить 1–7 днів.

Дні є об’єктами datetime.date . yeardays2calendar ( year , width = 3 ) ¶ Повертає дані за вказаний рік, готові до форматування (подібно до yeardatescalendar() ). Записи в тижневих списках є кортежами номерів днів і днів тижня. Номери днів поза цим місяцем дорівнюють нулю. yeardayscalendar ( year , width = 3 ) ¶ Повертає дані за вказаний рік, готові до форматування (подібно до yeardatescalendar() ).

Записи в тижневих списках є номерами днів. Номери днів поза цим місяцем дорівнюють нулю. class calendar. TextCalendar ( firstweekday = 0 ) ¶ Цей клас можна використовувати для створення простих текстових календарів. Екземпляри TextCalendar мають такі методи: prweek ( theweek , width ) ¶ Print a week’s calendar as returned by formatweek() and without a final newline. formatday ( day , weekday , width ) ¶ Return a string representing a single day formatted with the given width .

If day is 0 , return a string of spaces of the specified width, representing an empty day. The weekday parameter is unused. formatweek ( theweek , width ) ¶ Return a single week in a string with no newline. width specifies the width of the date columns, which are centered. Depends on the first weekday as specified in the constructor or set by the setfirstweekday() method. formatweekday ( day , width

The rest of this page is on the live site.