На этом шаге мы рассмотрим основные методы этого класса.

    Экземпляры класса date поддерживают следующие методы:

• replace ( [year] [, month] [, day]) - возвращает дату с обновленными значениями. Значения можно указывать через запятую в порядке следования параметров или присвоить значение названию параметра. Примеры:

  >>> d = datetime.date (2015, 4, 3)
  >>> d.replace (2014, 12) # Заменяем год и месяц
  datetime.date(2014, 12, 3)
  >>> d.replace(year=2015, month=1, day=31)
  datetime.date(2015, 1, 31)
  >>> d.replace (day=30) # Заменяем только день
  datetime.date(2015, 4, 30)
  

• strftime (<Строка формата>) - возвращает отформатированную строку. В строке формата можно задавать комбинации специальных символов, которые используются в функции strftime() из модуля time. Пример:

  >>> d = datetime.date (2015, 4, 3)
  >>> d.strftime ("%d.%m.%Y")
  '03.04.2015'
  

• isoformat () - возвращает дату в формате ГГГГ-ММ-ДД:

  >>> d = datetime.date (2017, 9, 18)
  >>> d.isoformat()
  '2017-09-18'
  

• ctime () - возвращает строку формата "%a %b %d %H:%M:%S %Y":

  >>> d = datetime.date (2017, 9, 18)
  >>> d.ctime()
  'Mon Sep 18 00:00:00 2017'
  

• timetuple () - возвращает объект struct_time с датой и временем:

  >>> d = datetime.date (2017, 9, 18)
  >>> d.timetuple()
  time.struct_time(tm_year=2017, tm_mon=9, tm_mday=18, tm_hour=0, 
    tm_min=0, tm_sec=0, tm_wday=0, tm_yday=261, tm_isdst=-1)
  

• toordinal () - возвращает количество дней, прошедших с 1-го года:

  >>> d = datetime.date (2017, 9, 18)
  >>> d.toordinal()
  736590
  >>> datetime.date.fromordinal (736590)
  datetime.date(2017, 9, 18)
  

• weekday () - возвращает порядковый номер дня в неделе (0 - для понедельника, 6 - для воскресенья):

  >>> d = datetime.date (2017, 9, 18)
  >>> d.weekday () # 0 - это понедельник
  0
  

• isoweekday () - возвращает порядковый номер дня в неделе (1- для понедельника, 7 - для воскресенья):

  >>> d = datetime.date (2017, 9, 18)
  >>> d.isoweekday () # 1 - это понедельник
  1
  

• isocalendar () - возвращает кортеж из трех элементов (год, номер недели в году и порядковый номер дня в неделе):

  >>> d = datetime.date (2017, 9, 18)
  >>> d.isocalendar ()
  (2017, 38, 1)
  

    Наконец, имеется поддержка следующих атрибутов класса:

• min - минимально возможное значение даты;
• max - максимально возможное значение даты;
• resolution - минимальное возможное различие между значениями даты.

    Выведем значения этих атрибутов:

>>> datetime.date.min
datetime.date(1, 1, 1)
>>> datetime.date.max
datetime.date(9999, 12, 31)
>>> datetime.date.resolution
datetime.timedelta(1)

    На следующем шаге мы рассмотрим класс time.

Предыдущий шаг Содержание Следующий шаг