Class: QgsDateTimeEdit¶
- class qgis.gui.QgsDateTimeEdit¶
Bases:
PyQt5.QtWidgets.QDateTimeEdit
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 guarantee that NULL values will be correctly handled).See also
See also
QgsDateTimeEdit(parent: QWidget = None) 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.
Methods
If the widget allows setting null date/time.
Set the current date as NULL.
Returns the date which can be a null date.
Returns the date time which can be a null date/time.
write the null value representation to the line edit without changing the value
Emits the widget's correct value changed signal.
- param event
- param event
Returns
True
if the widget is currently set to a null value- param event
Returns the widget's NULL representation, which defaults to
QgsApplication.nullRepresentation()
.Determines if the widget allows setting null date/time.
Set the date time in the widget and handles null date times.
Resets the widget to show no value (ie, an "unknown" state).
Sets the widget's
null
representation, which defaults toQgsApplication.nullRepresentation()
.- param event
Returns the time which can be a null time.
- param event
Signals
Signal emitted whenever the value changes.
- actionEvent(self, QActionEvent)¶
- allowNull(self) bool ¶
If the widget allows setting null date/time.
See also
- 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
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)¶
- displayNull(self, updateCalendar: bool = False)¶
write the null value representation to the line edit without changing the value
- Parameters
updateCalendar (bool = False) – 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)¶
Emits the widget’s correct value changed signal.
- Parameters
value (Any) –
- 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)¶
- isNull(self) bool ¶
Returns
True
if the widget is currently set to a null value- Return type
bool
- 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] ¶
- nullRepresentation(self) str ¶
Returns the widget’s NULL representation, which defaults to
QgsApplication.nullRepresentation()
.See also
New in version 3.14.
- Return type
str
- 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
- 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)¶
- setNullRepresentation(self, null: str)¶
Sets the widget’s
null
representation, which defaults toQgsApplication.nullRepresentation()
.See also
New in version 3.14.
- Parameters
null (str) –
- 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) –