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

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

• datetime2 = datetime1 + timedelta - прибавляет к дате указанный период;
• datetime2 = datetime1 - timedelta - вычитает из даты указанный период;
• timedelta = datetime1 - datetime2 - возвращает разницу между датами;
• можно также сравнивать две даты с помощью операторов сравнения.

    Примеры:

>> d1 = datetime.datetime (2017, 11, 10, 16, 7, 22)
>> d2 = datetime.datetime (2017, 11, 20, 16, 7, 22)
>> t = datetime.timedelta (days=10, minutes=10)
>> d1 + t # Прибавляем 10 дней и 10 минут
datetime.datetime(2017, 11, 20, 16, 17, 22)
>> d1 - t # Вычитаем 10 дней и 10 минут
datetime.datetime(2017, 10, 31, 15, 57, 22)
>> d1 - d2 # Разница между датами
datetime.timedelta(-10)(5, 12978)
>> d1 < d2, d1 > d2, d1 <= d2, d1 >= d2 
(True, False, True, False)
>> d1 == d2, d1 != d2
(False, True)

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

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

  >> d = datetime.datetime (2017, 11, 10, 16, 10, 54)
  >> d.date()
  datetime.date(2017, 11, 10)
  

• time () - возвращает экземпляр класса time, хранящий время:

  >> d = datetime.datetime (2017, 11, 10, 16, 10, 54)
  >> d.time()
  datetime.time(16, 10, 54)
  

• timetz () - возвращает экземпляр класса time, хранящий время. Метод учитывает параметр tzinfo;
• timestamp () - возвращает вещественное число, представляющее количество секунд, прошедшее с начала эпохи (обычно с 1 января 1970 г.). Поддержка этого метода появилась в Python 3.3. Пример:

  >> d = datetime.datetime (2017, 11, 10, 16, 10, 54)
  >> d.timestamp()
  1510312254.0
  

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

  >> d = datetime.datetime (2017, 11, 10, 16, 10, 54)
  >> d.replace (2014, 12)
  datetime.datetime(2014, 12, 10, 16, 10, 54)
  >> d.replace (hour=12, month=10)
  datetime.datetime(2017, 10, 10, 12, 10, 54)
  

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

  >> d = datetime.datetime (2017, 11, 10, 16, 10, 54)
  >> d.timetuple()
  time.struct_time(tm_year=2017, tm_mon=11, tm_mday=10, tm_hour=16, tm_min=10, 
  tm_sec=54, tm_wday=4, tm_yday=314, tm_isdst=-1)
  

• utctimetuple () - возвращает объект struct_time с датой в универсальном времени (UTC):

  >> d = datetime.datetime (2017, 11, 10, 16, 10, 54)
  >> d.utctimetuple ()
  time.struct_time(tm_year=2017, tm_mon=11, tm_mday=10, tm_hour=16, tm_min=10, 
  tm_sec=54, tm_wday=4, tm_yday=314, tm_isdst=0)
  

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

  >> d.toordinal()
  736643
  

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

  >> d = datetime.datetime (2017, 11, 10, 16, 10, 54)
  >> d.weekday() # 4 - это пятница
  4
  

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

  >> d = datetime.datetime (2017, 11, 10, 16, 10, 54)
  >> d.isoweekday() # 5 - это пятница
  5
  

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

  >> d = datetime.datetime (2017, 11, 10, 16, 10, 54)
  >> d.isocalendar()
  (2017, 45, 5)
  

• isoformat ( [<Разделитель даты и времени>] ) - возвращает дату в формате ISO 8601. Если разделитель не указан, используется буква T. Примеры:

  >> d = datetime.datetime (2017, 11, 10, 16, 10, 54)
  >> d.isoformat () # Разделитель не указан
  '2017-11-10T16:10:54'
  >> d.isoformat (" ") # Пробел в качестве разделителя
  '2017-11-10 16:10:54'
  

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

  >> d = datetime.datetime (2017, 11, 10, 16, 10, 54)
  >> d.ctime()
  'Fri Nov 10 16:10:54 2017'
  

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

  >> d.strftime ("%d.%m.%Y  %H:%M:%S")
  '10.11.2017  16:10:54'
  

    Поддерживаются также следующие атрибуты класса:

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

    Значения этих атрибутов:

>> datetime.datetime.min
datetime.datetime(1, 1, 1, 0, 0)
>> datetime.datetime.max
datetime.datetime(9999, 12, 31, 23, 59, 59, 999999)
>> datetime.datetime.resolution	
datetime.timedelta(0, 0, 1)

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

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