QDateTimeEdit Class

Member Function Documentation

[explicit] QDateTimeEdit::QDateTimeEdit(QWidget *parent = nullptr)

Constructs an empty date time editor with a parent.

[explicit] QDateTimeEdit::QDateTimeEdit(const QDateTime &datetime, QWidget *parent = nullptr)

Constructs an empty date time editor with a parent. The value is set to datetime.

[explicit] QDateTimeEdit::QDateTimeEdit(QDate date, QWidget *parent = nullptr)

Constructs an empty date time editor with a parent. The value is set to date.

[explicit] QDateTimeEdit::QDateTimeEdit(QTime time, QWidget *parent = nullptr)

Constructs an empty date time editor with a parent. The value is set to time.

[virtual] QDateTimeEdit::~QDateTimeEdit()

Destructor.

QCalendar QDateTimeEdit::calendar() const

Report the calendar system in use by this widget.

See also setCalendar().

QCalendarWidget *QDateTimeEdit::calendarWidget() const

Returns the calendar widget for the editor if calendarPopup is set to true and (sections() & DateSections_Mask) != 0.

This function creates and returns a calendar widget if none has been set.

See also setCalendarWidget().

[override virtual] void QDateTimeEdit::clear()

Reimplements: QAbstractSpinBox::clear().

QDate QDateTimeEdit::date() const

Returns the date of the date time edit.

See also setDate().

[signal] void QDateTimeEdit::dateChanged(QDate date)

This signal is emitted whenever the date is changed. The new date is passed in date.

See also Keyboard Tracking.

[signal] void QDateTimeEdit::dateTimeChanged(const QDateTime &datetime)

This signal is emitted whenever the date or time is changed. The new date and time is passed in datetime.

See also Keyboard Tracking.

[virtual protected] QDateTime QDateTimeEdit::dateTimeFromText(const QString &text) const

Returns an appropriate datetime for the given text.

This virtual function is used by the datetime edit whenever it needs to interpret text entered by the user as a value.

See also textFromDateTime() and validate().

[override virtual] bool QDateTimeEdit::event(QEvent *event)

Reimplements: QAbstractSpinBox::event(QEvent *event).

[override virtual protected] void QDateTimeEdit::fixup(QString &input) const

Reimplements: QAbstractSpinBox::fixup(QString &input) const.

[override virtual protected] void QDateTimeEdit::focusInEvent(QFocusEvent *event)

Reimplements: QAbstractSpinBox::focusInEvent(QFocusEvent *event).

[override virtual protected] bool QDateTimeEdit::focusNextPrevChild(bool next)

Reimplements: QWidget::focusNextPrevChild(bool next).

[override virtual protected] void QDateTimeEdit::initStyleOption(QStyleOptionSpinBox *option) const

Reimplements: QAbstractSpinBox::initStyleOption(QStyleOptionSpinBox *option) const.

Initialize option with the values from this QDataTimeEdit. This method is useful for subclasses when they need a QStyleOptionSpinBox, but don't want to fill in all the information themselves.

See also QStyleOption::initFrom().

[override virtual protected] void QDateTimeEdit::keyPressEvent(QKeyEvent *event)

Reimplements: QAbstractSpinBox::keyPressEvent(QKeyEvent *event).

[override virtual protected] void QDateTimeEdit::mousePressEvent(QMouseEvent *event)

Reimplements: QAbstractSpinBox::mousePressEvent(QMouseEvent *event).

[override virtual protected] void QDateTimeEdit::paintEvent(QPaintEvent *event)

Reimplements: QAbstractSpinBox::paintEvent(QPaintEvent *event).

QDateTimeEdit::Section QDateTimeEdit::sectionAt(int index) const

Returns the Section at index.

If the format is 'yyyy/MM/dd', sectionAt(0) returns YearSection, sectionAt(1) returns MonthSection, and sectionAt(2) returns YearSection,

QString QDateTimeEdit::sectionText(QDateTimeEdit::Section section) const

Returns the text from the given section.

See also currentSection().

void QDateTimeEdit::setCalendar(QCalendar calendar)

Set calendar as the calendar system to be used by this widget.

The widget can use any supported calendar system. By default, it uses the Gregorian calendar.

See also calendar().

void QDateTimeEdit::setCalendarWidget(QCalendarWidget *calendarWidget)

Sets the given calendarWidget as the widget to be used for the calendar pop-up. The editor does not automatically take ownership of the calendar widget.

See also calendarWidget() and calendarPopup.

void QDateTimeEdit::setDateRange(QDate min, QDate max)

Set the range of allowed dates for the date time edit.

This convenience function sets the minimumDate and maximumDate properties.

setDateRange(min, max);

is analogous to:

setMinimumDate(min);
setMaximumDate(max);

If either min or max is invalid, this function does nothing. This function preserves the minimumTime property. If max is less than min, the new maximumDateTime property shall be the new minimumDateTime property. If max is equal to min and the maximumTime property was less then the minimumTime property, the maximumTime property is set to the minimumTime property. Otherwise, this preserves the maximumTime property.

If the range is narrower then a time interval whose end it spans, for example a week that spans the end of a month, users can only edit the date to one in the later part of the range if keyboard-tracking is disabled.

See also minimumDate, maximumDate, setDateTimeRange(), QDate::isValid(), and Keyboard Tracking.

void QDateTimeEdit::setDateTimeRange(const QDateTime &min, const QDateTime &max)

Set the range of allowed date-times for the date time edit.

This convenience function sets the minimumDateTime and maximumDateTime properties.

setDateTimeRange(min, max);

is analogous to:

setMinimumDateTime(min);
setMaximumDateTime(max);

If either min or max is invalid, this function does nothing. If max is less than min, min is used also as max.

If the range is narrower then a time interval whose end it spans, for example a week that spans the end of a month, users can only edit the date-time to one in the later part of the range if keyboard-tracking is disabled.

See also minimumDateTime, maximumDateTime, setDateRange(), setTimeRange(), QDateTime::isValid(), and Keyboard Tracking.

void QDateTimeEdit::setSelectedSection(QDateTimeEdit::Section section)

Selects section. If section doesn't exist in the currently displayed sections, this function does nothing. If section is NoSection, this function will unselect all text in the editor. Otherwise, this function will move the cursor and the current section to the selected section.

See also currentSection().

void QDateTimeEdit::setTimeRange(QTime min, QTime max)

Set the range of allowed times for the date time edit.

This convenience function sets the minimumTime and maximumTime properties.

Note that these only constrain the date time edit's value on, respectively, the minimumDate and maximumDate. When these date properties do not coincide, times after max are allowed on dates before maximumDate and times before min are allowed on dates after minimumDate.

setTimeRange(min, max);

is analogous to:

setMinimumTime(min);
setMaximumTime(max);

If either min or max is invalid, this function does nothing. This function preserves the minimumDate and maximumDate properties. If those properties coincide and max is less than min, min is used as max.

If the range is narrower then a time interval whose end it spans, for example the interval from ten to an hour to ten past the same hour, users can only edit the time to one in the later part of the range if keyboard-tracking is disabled.

See also minimumTime, maximumTime, setDateTimeRange(), QTime::isValid(), and Keyboard Tracking.

[override virtual] QSize QDateTimeEdit::sizeHint() const

Reimplements: QAbstractSpinBox::sizeHint() const.

[override virtual] void QDateTimeEdit::stepBy(int steps)

Reimplements: QAbstractSpinBox::stepBy(int steps).

[override virtual protected] QAbstractSpinBox::StepEnabled QDateTimeEdit::stepEnabled() const

Reimplements: QAbstractSpinBox::stepEnabled() const.

[virtual protected] QString QDateTimeEdit::textFromDateTime(const QDateTime &dateTime) const

This virtual function is used by the date time edit whenever it needs to display dateTime.

If you reimplement this, you may also need to reimplement validate().

See also dateTimeFromText() and validate().

QTime QDateTimeEdit::time() const

Returns the time of the date time edit.

See also setTime().

[signal] void QDateTimeEdit::timeChanged(QTime time)

This signal is emitted whenever the time is changed. The new time is passed in time.

See also Keyboard Tracking.

[override virtual protected] QValidator::State QDateTimeEdit::validate(QString &text, int &pos) const

Reimplements: QAbstractSpinBox::validate(QString &input, int &pos) const.

[override virtual protected] void QDateTimeEdit::wheelEvent(QWheelEvent *event)

Reimplements: QAbstractSpinBox::wheelEvent(QWheelEvent *event).