Class: QgsDateTimeEdit

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

Bases: PyQt5.QtWidgets.QDateTimeEdit

Constructor for QgsDateTimeEdit. The current date and 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 QgsDateTimeEdit class is a QDateTimeEdit with the capability of setting/reading null date/times.

Warning

You should use the signal valueChanged of this subclass rather than QDateTimeEdit.dateTimeChanged. If you consequently connect parent’s dateTimeChanged signal and call dateTime() afterwards there is no warranty to have a proper NULL value handling.

Parameters

parent

actionEvent(self, QActionEvent)
allowNull(self) → bool

If the widget allows setting null date/time.

See also

setAllowNull()

Return type

bool

changeEvent(self, QEvent)
childEvent(self, QChildEvent)
clear(self)

Set the current date as NULL.

Note

If the widget is not configured to accept NULL dates, this will have no effect.

closeEvent(self, QCloseEvent)
connectNotify(self, QMetaMethod)
contextMenuEvent(self, QContextMenuEvent)
create(self, window: sip.voidptr = 0, initializeWindow: bool = True, destroyOldWindow: bool = True)
customEvent(self, QEvent)
date(self) → QDate

Returns the date which can be a null date.

New in version 3.10.

Return type

QDate

dateTime(self) → QDateTime

Returns the date time which can be a null date/time.

Note

Before QGIS 3.10, you mustn’t call date() or time() because they can’t return a NULL value.

Note

Since QDateTimeEdit.dateTime() is not virtual, dateTime must be called for QgsDateTimeEdit.

Return type

QDateTime

dateTimeFromText(self, str) → QDateTime
destroy(self, destroyWindow: bool = True, destroySubWindows: bool = True)
disconnectNotify(self, QMetaMethod)
dragEnterEvent(self, QDragEnterEvent)
dragLeaveEvent(self, QDragLeaveEvent)
dragMoveEvent(self, QDragMoveEvent)
dropEvent(self, QDropEvent)
enterEvent(self, QEvent)
fixup(self, str) → str
focusInEvent(self, event: QFocusEvent)
Parameters

event (QFocusEvent) –

focusNextChild(self) → bool
focusNextPrevChild(self, bool) → bool
focusOutEvent(self, event: QFocusEvent)
Parameters

event (QFocusEvent) –

focusPreviousChild(self) → bool
hideEvent(self, QHideEvent)
initPainter(self, QPainter)
initStyleOption(self, QStyleOptionSpinBox)
inputMethodEvent(self, QInputMethodEvent)
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)
Parameters

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
setAllowNull(self, allowNull: bool)

Determines if the widget allows setting null date/time.

See also

allowNull()

Parameters

allowNull (bool) –

setDateTime(self, dateTime: Union[QDateTime, datetime.datetime])

Set the date time in the widget and handles null date times.

Note

Since QDateTimeEdit.setDateTime() is not virtual, setDateTime must be called for QgsDateTimeEdit.

Parameters

dateTime (Union[QDateTime) –

setEmpty(self)

Resets the widget to show no value (ie, an “unknown” state).

New in version 2.16.

setLineEdit(self, QLineEdit)
sharedPainter(self) → QPainter
showEvent(self, event: QShowEvent)
Parameters

event (QShowEvent) –

stepEnabled(self) → QAbstractSpinBox.StepEnabled
tabletEvent(self, QTabletEvent)
textFromDateTime(self, Union[QDateTime, datetime.datetime]) → str
time(self) → QTime

Returns the time which can be a null time.

New in version 3.10.

Return type

QTime

timerEvent(self, QTimerEvent)
updateMicroFocus(self)
validate(self, str, int) → Tuple[QValidator.State, str, int]
valueChanged

Signal emitted whenever the value changes.

Parameters

date (Union[QDateTime) – The new date/time value. [signal]

wheelEvent(self, event: QWheelEvent)
Parameters

event (QWheelEvent) –