Class: QgsTimeEdit

class qgis.gui.QgsTimeEdit(parent: QWidget = None)

Bases: QgsDateTimeEdit

Constructor for QgsTimeEdit. The current time is used by default. The widget is allowing null by default. If allow null is disabled, you should check allowNull before getting values from the widget.

The QgsTimeEdit class is a QTimeEdit widget with the capability of setting/reading null date/times.


You should use the signal valueChanged of this subclass rather than QDateTimeEdit.timeChanged. (If you consequently connect parent’s timeChanged signal and call time() afterwards there is no guarantee that NULL values will be correctly handled).

See also


See also


New in version 3.14.



actionEvent(self, QActionEvent)
changeEvent(self, QEvent)
childEvent(self, QChildEvent)
closeEvent(self, QCloseEvent)
connectNotify(self, QMetaMethod)
contextMenuEvent(self, QContextMenuEvent)
create(self, window: sip.voidptr = 0, initializeWindow: bool = True, destroyOldWindow: bool = True)
customEvent(self, QEvent)
dateTimeFromText(self, str) → QDateTime
destroy(self, destroyWindow: bool = True, destroySubWindows: bool = True)
disconnectNotify(self, QMetaMethod)
displayNull(self, updateCalendar: bool = False)

write the null value representation to the line edit without changing the value


updateCalendar – Flag if calendar is open and minimum date needs to be set

dragEnterEvent(self, QDragEnterEvent)
dragLeaveEvent(self, QDragLeaveEvent)
dragMoveEvent(self, QDragMoveEvent)
dropEvent(self, QDropEvent)
emitValueChanged(self, value: Any)

value (Any) –

enterEvent(self, QEvent)
fixup(self, str) → str
focusInEvent(self, event: QFocusEvent)
focusNextChild(self) → bool
focusNextPrevChild(self, bool) → bool
focusOutEvent(self, event: QFocusEvent)
focusPreviousChild(self) → bool
hideEvent(self, QHideEvent)
initPainter(self, QPainter)
initStyleOption(self, QStyleOptionSpinBox)
inputMethodEvent(self, QInputMethodEvent)
isNull(self) → bool

Returns True if the widget is currently set to a null value

isSignalConnected(self, QMetaMethod) → bool
keyPressEvent(self, QKeyEvent)
keyReleaseEvent(self, QKeyEvent)
leaveEvent(self, QEvent)
lineEdit(self) → QLineEdit
metric(self, QPaintDevice.PaintDeviceMetric) → int
mouseDoubleClickEvent(self, QMouseEvent)
mouseMoveEvent(self, QMouseEvent)
mousePressEvent(self, event: QMouseEvent)
mouseReleaseEvent(self, QMouseEvent)
moveEvent(self, QMoveEvent)
nativeEvent(self, Union[QByteArray, bytes, bytearray], sip.voidptr) → Tuple[bool, int]
paintEvent(self, QPaintEvent)
receivers(self, PYQT_SIGNAL) → int
resizeEvent(self, QResizeEvent)
sender(self) → QObject
senderSignalIndex(self) → int
setLineEdit(self, QLineEdit)
setTime(self, time: Union[QTime, datetime.time])

Sets the time for the widget and handles null times.


Since QDateTimeEdit.setTime() is not virtual, setTime must be called for QgsTimeEdit.


time (Union[QTime) –

sharedPainter(self) → QPainter
showEvent(self, event: QShowEvent)
stepEnabled(self) → QAbstractSpinBox.StepEnabled
tabletEvent(self, QTabletEvent)
textFromDateTime(self, Union[QDateTime, datetime.datetime]) → str

Signal emitted whenever the time changes. [signal]


time (Union[QTime) –

timerEvent(self, QTimerEvent)
validate(self, str, int) → Tuple[QValidator.State, str, int]
wheelEvent(self, event: QWheelEvent)