На этом шаге мы рассмотрим назначение и использование этого класса.

    Класс date из модуля datetime позволяет выполнять операции над датами. Конструктор класса имеет следующий формат:

  date (<Год>, <Месяц>, <День>)

    Все параметры являются обязательными, В параметрах можно указать следующий диапазон значений:

• <Год> - в виде числа, расположенного в диапазоне между значениями, хранящимися в константах MINYEAR и MAXYEAR класса datetime (о нем речь пойдет в одном из следующих шагов). Выведем значения этих констант:

  >>> import datetime
  >>> datetime.MINYEAR, datetime.MAXYEAR
  (1, 9999)
  

• <Месяц> - от l до 12 включительно;
• <День> - от 1 до количества дней в месяце.

    Если значения выходят за диапазон, возбуждается исключение ValueError. Пример:

>>> datetime.date (2015, 4, 3)
datetime.date(2015, 4, 3)

>>> datetime.date (2015, 13, 3) # Неправильное значение для месяца
Traceback (most recent call last):
  File "<pyshell#4>", line 1, in <module>
    datetime.date (2015, 13, 3) # Неправильное значение для месяца
ValueError: month must be in 1..12
>>> d = datetime.date (2015, 4, 3)
>>> repr(d), str(d)
('datetime.date(2015, 4, 3)', '2015-04-03')

    Для создания объекта класса date также можно воспользоваться следующими методами этого класса:

• today () - возвращает текущую дату:

  >>> datetime.date.today () # Получаем текущую дату
  datetime.date(2017, 9, 18)
  

• fromtimestamp (<Количество секунд>) -возвращает дату, соответствующую количеству секунд, прошедших с начала эпохи:

  >>> import datetime, time
  >>> datetime.date.fromtimestamp (time.time()) # Текущая дата
  datetime.date(2017, 9, 18)
  >>> datetime.date.fromtimestamp(1321954972.0) # Дата 22-11-2011
  datetime.date(2011, 11, 22)
  

• fromordinal (<Количество дней с 1-го года>) - возвращает дату, соответствующую количеству дней, прошедших с первого года. В качестве параметра указывается число от 1 до datetime.date.max.toordinal(). Примеры:

  >>> datetime.date.max.toordinal()
  3652059
  >>> datetime.date.fromordinal(3652059)
  datetime.date(9999, 12, 31)
  >>> datetime.date.fromordinal(1)
  datetime.date(1, 1, 1)
  

    Получить результат можно с помощью следующих атрибутов:

• year - год (число в диапазоне от MINYEAR до MAXYEAR);
• month - месяц (число от 1 до 12);
• day - день (число от 1 до количества дней в месяце).

    Пример:

>>> d = datetime.date.today () # Текущая дата
>>> d.year, d.month, d.day
(2017, 9, 18)

    Над экземплярами класса date можно производить следующие операции:

• date2 = date1 + timedelta - прибавляет к дате указанный период в днях. Значения атрибутов timedelta.seconds и timedelta.microseconds игнорируются;
• date2 = date1 - timedelta - вычитает из даты указанный период в днях. Значения атрибутов timedelta.seconds и timedelta.microseconds игнорируются;
• timedelta = date1 - date2 - возвращает разницу между датами (период в днях). Атрибуты timedelta.seconds и timedelta.microseconds будут иметь значение 0;
• можно также сравнивать две даты с помощью операторов сравнения.

    Примеры:

>>> d1 = datetime.date (2015, 4, 3)
>>> d2 = datetime.date (2015, 1,1)
>>> t = datetime.timedelta (days=10)
>>> d1 + t, d1 - t # Прибавляем и вычитаем 10 дней
(datetime.date(2015, 4, 13), datetime.date(2015, 3, 24))
>>> d1 - d2 # Разница между датами
datetime.timedelta(92)
>>> d1 < d2, d1 > d2, d1 <= d2, d1 >= d2
(False, True, False, True)
>>> d1 == d2, d1 != d2
(False, True)

    На следующем шаге мы закончим изучение этого вопроса.

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