Шаг 121.
Библиотека PyQt5.
Основные компоненты. Поля для ввода даты и времени (окончание)

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

    Класс QDateTimeEdit наследует все методы из класса QAbstractSpinBox (см. 118 шаг) и дополнительно реализует следующие методы (здесь приведены только самые полезные - полный их список доступен на странице https://doc.qt.io/qt-5/qdatetimeedit.html):

• setDateTime (<QDateTime>) - устанавливает дату и время. В качестве параметра указывается экземпляр класса QDateTime или экземпляр класса datetime из языка Python. Метод является слотом;

• setDate (<QDate>) - устанавливает дату. В качестве параметра указывается экземпляр класса QDate или экземпляр класса date языка Python. Метод является слотом;

• setTime (<QTime>) - устанавливает время. В качестве параметра указывается экземпляр класса QTime или экземпляр класса time из языка Python. Метод является слотом;

• dateTime () - возвращает экземпляр класса QDateTime с датой и временем;

• date () - возвращает экземпляр класса QDate с датой;

• time () - возвращает экземпляр класса QTime со временем;

• setDateTimeRange (<Минимум>, <Максимум>), setMinimumDateTime (<Минимум>) и setMaximumDateTime (<Максимум>) - задают минимальное и максимальное допустимые значения для даты и времени. В параметрах указывается экземпляр класса QDateTime или экземпляр класса datetime из языка Python;

• setDateRange (<Минимум>, <Максимум>), setMinimumDate (<Минимум>) и setMaximumDate (<Максимум>) - задают минимальное и максимальное допустимые значения для даты. В параметрах указывается экземпляр класса QDate или экземпляр класса date из языка Python;

• setTimeRange (<Минимум>, <Максимум>), setMinimumTime (<Минимум>) и setMaximumTime (<Максимум>) - задают минимальное и максимальное допустимые значения для времени. В параметрах указывается экземпляр класса QTime или экземпляр класса time из языка Python;

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

    dateTimeEdit.setDisplayFormat("dd.MM.yyyy HH:mm:ss")
  

• setTimeSpec (<Зона>) - задает зону времени. В качестве параметра можно указать атрибуты LocalTime, UTC или OffsetFromUTC класса QtCore.Qt;

• setCalendarPopup (<Флаг>) - если в качестве параметра указано значение True, то дату можно будет выбрать с помощью календаря, который появится на экране при щелчке на кнопке с направленной вниз стрелкой, выведенной вместо стандартных кнопок-стрелок (рисунок 1);

  
  Рис.1. Компонент QDateEdit с открытым календарем

      Текст приложения:

  # -*- coding: utf-8 -*-
  from PyQt5 import QtWidgets, QtCore
  import sys
  import datetime
  app = QtWidgets.QApplication(sys.argv)
  window = QtWidgets.QWidget()
  window.setWindowTitle("QDateEdit")
  now = datetime.datetime.now() # Получить текущую дату
  dateedit = QtWidgets.QDateEdit(now) # Использовать ее в конструкторе
  dateedit.setCalendarPopup(True)  # Эта строка добавлена
  vbox = QtWidgets.QVBoxLayout()
  vbox.addWidget(dateedit)
  window.setLayout(vbox)
  window.show()
  sys.exit(app.exec_())
  

  Архив с файлом можно взять здесь.

• setSelectedSection (<Секция>) - выделяет указанную секцию. В качестве параметра можно задать атрибуты NoSection, DaySection, MonthSection, YearSection, HourSection, MinuteSection, SecondSection, MSecSection или AmPmSection класса QDateTimeEdit;

• setCurrentSection (<Секция>) - делает указанную секцию текущей;

• setCurrentSectionIndex (<Индекс>) - делает секцию с указанным индексом текущей;

• currentSection () - возвращает тип текущей секции;

• currentSectionIndex () - возвращает индекс текущей секции;

• sectionCount () - возвращает количество секций внутри поля;

• sectionAt (<Индекс>) - возвращает тип секции по указанному индексу;

• sectionText (<Секция>) - возвращает текст указанной секции.

    При изменении значений даты или времени генерируются сигналы timeChanged (<QTime>), dateChanged (<QDate>) и dateTimeChanged (<QDateTime>). Внутри обработчиков через параметр доступно новое значение.

    Классы QDateEdit (поле для ввода даты) и QTimeEdit (поле для ввода времени) созданы для удобства и отличаются от класса QDateTimeEdit только форматом отображаемых данных. Эти классы наследуют методы базовых классов и не добавляют никаких своих методов.

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

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