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

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

  datetime(<Год>, <Месяц>, <День>[, hour][, minute][, second]
    [, microsecond][, tzinfo])

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

• <Год> - в виде числа, расположенного в диапазоне между значениями, хранящимися в константах MINYEAR (1) и MAXYEAR (9999);
• <Месяц> - число от 1 до 12 включительно;
• <День> - число от 1 до количества дней в месяце;
• hour - часы (число от о до 23);
• minute - минуты (число от 0 до 59);
• second - секунды (число от 0 до 59);
• microsecond - микросекунды (число от 0 до 999999);
• tzinfo - зона (экземпляр класса tzinfo или значение None).

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

>> import datetime
>> datetime.datetime (2017, 10, 27)
datetime.datetime(2017, 10, 27, 0, 0)
>> datetime.datetime (2017, 10, 27, hour=12, minute=55)
datetime.datetime(2017, 10, 27, 12, 55)
>> datetime.datetime (2017, 32, 20)
Traceback (most recent call last):
  File "<pyshell#3>", line 1, in <module>
    datetime.datetime (2017, 32, 20)
ValueError: month must be in 1..12
>> d = datetime.datetime (2017, 10, 27, 16, 1, 5)
>> repr(d), str(d)
('datetime.datetime(2017, 10, 27, 16, 1, 5)', '2017-10-27 16:01:05')

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

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

  >> datetime.datetime.today ()
  datetime.datetime(2017, 10, 27, 5, 46, 24)
  

• now ( [<Зона>]) - возвращает текущие дату и время. Если параметр не задан, то метод аналогичен методу today (). Пример:

  >> datetime.datetime.now()
  datetime.datetime(2017, 10, 27, 5, 35, 34, 671875)
  

• utcnow () - возвращает текущее универсальное время (UTC):

  >> datetime.datetime.utcnow ()
  datetime.datetime(2017, 10, 26, 23, 35, 46, 421875)
  

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

  >> import datetime, time
  >> datetime.datetime.fromtimestamp ( time.time () ) 
  datetime.datetime(2017, 10, 27, 5, 36, 3, 609375)
  >> datetime.datetime.fromtimestamp (1421579037.0) 
  datetime.datetime(2015, 1, 18, 17, 3, 57)
  

• utcfromtimestamp (<Количество секунд>) - возвращает дату, соответствующую количеству секунд, прошедших с начала эпохи, в универсальном времени (UTC). Примеры:

  >> datetime.datetime.utcfromtimestamp ( time.time () ) 
  datetime.datetime(2017, 10, 26, 23, 36, 27, 359375)
  >> datetime.datetime.utcfromtimestamp (1421579037.0)
  datetime.datetime(2015, 1, 18, 11, 3, 57)
  

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

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

• combine (<Экземпляр класса date>, <Экземпляр класса time>) - создает экземпляр класса datetime в соответствии со значениями экземпляров классов date и time:

  >> d = datetime.date (2017, 10, 27)  # Экземпляр класса date
  >> t = datetime.time (16, 7, 22)   # Экземпляр класса time
  >> datetime.datetime.combine (d, t)
  datetime.datetime(2017, 10, 27, 16, 7, 22)
  

• strptime (<Строка с датой>, <Строка формата>) - разбирает строку, указанную в первом параметре, в соответствии со строкой формата. Если строка не соответствует формату, возбуждается исключение VaiueError. Примеры:

  >> datetime.datetime.strptime ("27.10.2017", "%d.%m.%Y")
  datetime.datetime(2017, 10, 27, 0, 0)
  >> datetime.datetime.strptime ("27.10.2017", "%d-%m-%Y")
  Traceback (most recent call last):
    File "<pyshell#24>", line 1, in <module>
      datetime.datetime.strptime("27.10.2017", "%d-%m-%Y")
    File "C:\Python34\lib\_strptime.py", line 507, in _strptime_datetime
      tt, fraction = _strptime(data_string, format)
    File "C:\Python34\lib\_strptime.py", line 344, in _strptime
      (data_string, format))
  ValueError: time data '27.10.2017' does not match format '%d-%m-%Y'
  

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

• year - год (число в диапазоне от MINYEAR до MAXYEAR);
• month - месяц (число от 1 до 12);
• day - день (число от 1 до количества дней в месяце);
• hour - часы (число от 0 до 23);
• minute - минуты (число от 0 до 59);
• second - секунды (число от о до 59);
• microsecond - микросекунды (число от о до 999999);
• tzinfo - зона (экземпляр класса tzinfo или значение None).

    Примеры:

>> d = datetime.datetime (2017, 10, 27, 16, 7, 22)
>> d.year, d.month, d.day
(2017, 10, 27)
>> d.hour, d.minute, d.second, d.microsecond
(16, 7, 22, 0)

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

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