{"id":5030,"date":"2022-09-22T03:26:01","date_gmt":"2022-09-22T03:26:01","guid":{"rendered":"https:\/\/www.pythontutorial.net\/?page_id=5030"},"modified":"2022-09-22T03:26:14","modified_gmt":"2022-09-22T03:26:14","slug":"pyqt-qdatetimeedit","status":"publish","type":"page","link":"https:\/\/www.pythontutorial.net\/pyqt\/pyqt-qdatetimeedit\/","title":{"rendered":"PyQt QDateTimeEdit"},"content":{"rendered":"\n

Summary<\/strong>: in this tutorial, you’ll learn how to create a date & time entry widget using the PyQt QDateTimeEdit<\/code><\/code> class.<\/p>\n\n\n\n

Introduction to the PyQt QDateTimeEdit widget #<\/a><\/h2>\n\n\n\n

The QDateTimeEdit<\/code><\/code> class allows you to create a widget for editing dates & times:<\/p>\n\n\n\n

\"PyQt<\/figure>\n\n\n\n

The QDateTimeEdit<\/code><\/code> widget allows you to edit the date and time using the keyboard or up\/down arrow keys to increase\/decrease the value. <\/p>\n\n\n\n

Also, you can use the left\/right arrow key to move between the day, month, year, hour, and minute sections of the entry.<\/p>\n\n\n\n

The QDateTimeEdit<\/code><\/code> has the following useful methods and properties:<\/p>\n\n\n\n

Property<\/th>Description<\/th><\/tr><\/thead>
date()<\/code><\/td>Return the date value displayed by the widget. The return type is QDate<\/code><\/code><\/code><\/code>. To convert it to a datetime.date<\/code> object, you use the toPyDate()<\/code> method of the QDate<\/code><\/code><\/code><\/code> class.<\/td><\/tr>
time()<\/code><\/td>Return the time displayed by the widget. The return value has the type of QTime<\/code><\/code><\/code>. Use the toPyTime()<\/code> method to convert it to a Python datetime.time<\/code> object.<\/td><\/tr>
dateTime()<\/code><\/td>Return the date and time value displayed by the widget. The return type is QDateTime<\/code><\/code>.<\/td><\/tr>
minimumDate<\/code><\/td>The earliest date that can be set by the user.<\/td><\/tr>
maximumDate<\/code><\/td>The latest date that can be set by the user.<\/td><\/tr>
minimumTime<\/code><\/td>The earliest time that can be set by the user.<\/td><\/tr>
maximumTime<\/code><\/td>The latest time that can be set by the user.<\/td><\/tr>
minimumDateTime<\/code><\/td>The earliest date & time that can be set by the user.<\/td><\/tr>
maximumDateTime<\/code><\/td>The latest date & time that can be set by the user.<\/td><\/tr>
calendarPopup<\/code><\/td>Display a calendar popup if it is True.<\/td><\/tr>
displayFormat<\/code><\/td>is a string that formats the date displayed in the widget.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

The QDateTimeEdit<\/code><\/code><\/code><\/code> emits the editingFinished()<\/code> signal when the editing is finished. If you want to trigger an action whenever the value of the QDateTimeEdit<\/code><\/code><\/code><\/code> widget changes, you can connect to the dateTimeChanged()<\/code> signal.<\/p>\n\n\n\n

If you want to create a widget for editing dates, you can use QDateEdit<\/a><\/code>. Similarly, you can use QTimeEdit<\/a><\/code> to create a widget for editing times only<\/p>\n\n\n\n

PyQt QDateTimeEdit widget example #<\/a><\/h2>\n\n\n\n

The following program uses the QDateTimeEdit<\/code><\/code> class to create a widget for editing date & time:<\/p>\n\n\n

import<\/span> sys\nfrom<\/span> PyQt6.QtWidgets import<\/span> QApplication, QWidget, QDateTimeEdit, QLabel, QFormLayout\n\n\nclass<\/span> MainWindow<\/span>(QWidget)<\/span>:<\/span>\n    def<\/span> __init__<\/span>(self, *args, **kwargs)<\/span>:<\/span>\n        super().__init__(*args, **kwargs)\n\n        self.setWindowTitle('PyQt QDateTimeEdit'<\/span>)\n        self.setMinimumWidth(200<\/span>)\n\n        layout = QFormLayout()\n        self.setLayout(layout)\n\n        self.datetime_edit = QDateTimeEdit(self, calendarPopup=True<\/span>)\n        self.datetime_edit.dateTimeChanged.connect(self.update)\n\n        self.result_label = QLabel(''<\/span>, self)\n\n        layout.addRow('Date:'<\/span>, self.datetime_edit)\n        layout.addRow(self.result_label)\n\n        self.show()\n\n    def<\/span> update<\/span>(self)<\/span>:<\/span>\n        value = self.datetime_edit.dateTime()\n        self.result_label.setText(value.toString(\"yyyy-MM-dd HH:mm\"<\/span>))\n\n\nif<\/span> __name__ == '__main__'<\/span>:\n    app = QApplication(sys.argv)\n    window = MainWindow()\n    sys.exit(app.exec())<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
How it works.<\/p>\n\n\n\n
First, create the QDateTimeEdit<\/code><\/code> widget:<\/p>\n\n\n
self.datetime_edit = QDateTimeEdit(self, calendarPopup=True<\/span>)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Second, connect the dateTimeChanged()<\/code> signal to the update()<\/code> method:<\/p>\n\n\n
self.date_edit.dateTimeChanged.connect(self.update)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Third, create a QLabel<\/code><\/code> widget to display the value of the date_edit<\/code><\/code> widget once the editing is finished:<\/p>\n\n\n
self.result_label = QLabel(''<\/span>, self)<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Finally, define the update()<\/code> method that updates the label widget with the current value of the date  & time entry:<\/p>\n\n\n
def<\/span> update<\/span>(self)<\/span>:<\/span>\n    value = self.datetime_edit.dateTime()\n    self.result_label.setText(value.toString(\"yyyy-MM-dd HH:mm\"<\/span>))<\/code><\/span>Code language:<\/span> Python<\/span> (<\/span>python<\/span>)<\/span><\/small><\/pre>\n\n\n
Output:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Summary #<\/a><\/h2>\n\n\n\n
  • Use the QDateTimeEdit<\/code><\/code> to create a date and time entry widget.<\/li>
  • Use the dateTime()<\/code> method to get the current value of the QDateTimeEdit<\/code><\/code> widget<\/li><\/ul>\n
    \n\t
    \n\t\t
    Was this tutorial helpful ?<\/div>\n\t\t
    \n\t\t\t\n\t\t\t\t\n\t\t\t\t\t<\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t Yes <\/span>\n\t\t\t<\/button>\n\n\t\t\t\n\t\t\t\t\n\t\t\t\t\t<\/path>\n\t\t\t\t<\/svg>\n\t\t\t\t No <\/span>\n\t\t\t<\/button>\n\t\t<\/div>\n\t<\/header>\n\n\t
    \n\t\t
    \n\t\t\t
    <\/div>\n\t\t\t