QDateTimeEdit Class

QDateTimeEdit *dateEdit = new QDateTimeEdit(QDate::currentDate());
dateEdit->setMinimumDate(QDate::currentDate().addDays(-365));
dateEdit->setMaximumDate(QDate::currentDate().addDays(365));
dateEdit->setDisplayFormat("yyyy.MM.dd");

Member Function Documentation

QDateTimeEdit::QDateTimeEdit(QWidget *parent = nullptr)

Constructs an empty date time editor with a parent.

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

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

QDateTimeEdit::QDateTimeEdit(const QDate &date, QWidget *parent = nullptr)

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

QDateTimeEdit::QDateTimeEdit(const QTime &time, QWidget *parent = nullptr)

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

[virtual] QDateTimeEdit::~QDateTimeEdit()

Destructor.

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.

This function was introduced in Qt 4.4.

See also setCalendarWidget().

[override virtual] void QDateTimeEdit::clear()

Reimplemented from QAbstractSpinBox::clear().

QDate QDateTimeEdit::date() const

Returns the date of the date time edit.

Note: Getter function for property date.

See also setDate().

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

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

Note: Notifier signal for property date.

[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.

Note: Notifier signal for property dateTime.

[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)

Reimplemented from QAbstractSpinBox::event().

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

Reimplemented from QAbstractSpinBox::fixup().

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

Reimplemented from QAbstractSpinBox::focusInEvent().

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

Reimplemented from QWidget::focusNextPrevChild().

[protected] void QDateTimeEdit::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)

Reimplemented from QAbstractSpinBox::keyPressEvent().

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

Reimplemented from QAbstractSpinBox::mousePressEvent().

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

Reimplemented from QAbstractSpinBox::paintEvent().

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,

This function was introduced in Qt 4.3.

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

Returns the text from the given section.

See also currentSection().

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.

Note: calendarPopup must be set to true before setting the calendar widget.

This function was introduced in Qt 4.4.

See also calendarWidget() and calendarPopup.

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

Convenience function to set minimum and maximum date with one function call.

setDateRange(min, max);

is analogous to:

setMinimumDate(min);
setMaximumDate(max);

If either min or max are not valid, this function does nothing.

See also setMinimumDate(), maximumDate(), setMaximumDate(), clearMinimumDate(), setMinimumTime(), maximumTime(), setMaximumTime(), clearMinimumTime(), and QDate::isValid().

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

Convenience function to set minimum and maximum date time with one function call.

setDateTimeRange(min, max);

is analogous to:

setMinimumDateTime(min);
setMaximumDateTime(max);

If either min or max are not valid, this function does nothing.

This function was introduced in Qt 4.4.

See also setMinimumDate(), maximumDate(), setMaximumDate(), clearMinimumDate(), setMinimumTime(), maximumTime(), setMaximumTime(), clearMinimumTime(), and QDateTime::isValid().

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.

This function was introduced in Qt 4.2.

See also currentSection().

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

Convenience function to set minimum and maximum time with one function call.

setTimeRange(min, max);

is analogous to:

setMinimumTime(min);
setMaximumTime(max);

If either min or max are not valid, this function does nothing.

See also setMinimumDate(), maximumDate(), setMaximumDate(), clearMinimumDate(), setMinimumTime(), maximumTime(), setMaximumTime(), clearMinimumTime(), and QTime::isValid().

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

Reimplemented from QAbstractSpinBox::sizeHint().

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

Reimplemented from QAbstractSpinBox::stepBy().

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

Reimplemented from QAbstractSpinBox::stepEnabled().

[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.

Note: Getter function for property time.

See also setTime().

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

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

Note: Notifier signal for property time.

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

Reimplemented from QAbstractSpinBox::validate().

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

Reimplemented from QAbstractSpinBox::wheelEvent().