com.trolltech.qt.gui
Class QDateTimeEdit

java.lang.Object
  extended by com.trolltech.qt.internal.QSignalEmitterInternal
      extended by com.trolltech.qt.QSignalEmitter
          extended by com.trolltech.qt.QtJambiObject
              extended by com.trolltech.qt.core.QObject
                  extended by com.trolltech.qt.gui.QWidget
                      extended by com.trolltech.qt.gui.QAbstractSpinBox
                          extended by com.trolltech.qt.gui.QDateTimeEdit
All Implemented Interfaces:
QPaintDeviceInterface, QtJambiInterface
Direct Known Subclasses:
QDateEdit, QTimeEdit

public class QDateTimeEdit
extends QAbstractSpinBox

The QDateTimeEdit class provides a widget for editing dates and times. QDateTimeEdit allows the user to edit dates by using the keyboard or the arrow keys to increase and decrease date and time values. The arrow keys can be used to move from section to section within the QDateTimeEdit box. Dates and times appear in accordance with the format set; see setDisplayFormat().

  QDateTimeEdit dateEdit = new QDateTimeEdit(QDate.currentDate());
  dateEdit.setMinimumDate(QDate.currentDate().addDays(-365));
  dateEdit.setMaximumDate(QDate.currentDate().addDays(365));
  dateEdit.setDisplayFormat("yyyy.MM.dd");
Here we've created a new QDateTimeEdit object initialized with today's date, and restricted the valid date range to today plus or minus 365 days. We've set the order to month, day, year.

The minimum value for QDateTimeEdit is 14 September 1752, and 2 January 4713BC for QDate. You can change this by calling setMinimumDate(), setMaximumDate(), setMinimumTime(), and setMaximumTime().

Using a Pop-up Calendar Widget

QDateTimeEdit can be configured to allow a QCalendarWidget to be used to select dates. This is enabled by setting the calendarPopup property. Additionally, you can supply a custom calendar widget for use as the calendar pop-up by calling the setCalendarWidget() function. The existing calendar widget can be retrieved with calendarWidget().


A date time editing widget shown in the Windows XP widget style.


A date time editing widget shown in the Macintosh widget style.


A date time editing widget shown in the Plastique widget style.

See also:
QDateEdit, QTimeEdit, QDate, and QTime.


Nested Class Summary
static class QDateTimeEdit.Section
           
static class QDateTimeEdit.Sections
           
 
Nested classes/interfaces inherited from class com.trolltech.qt.gui.QAbstractSpinBox
QAbstractSpinBox.ButtonSymbols, QAbstractSpinBox.CorrectionMode, QAbstractSpinBox.StepEnabled, QAbstractSpinBox.StepEnabledFlag
 
Nested classes/interfaces inherited from class com.trolltech.qt.gui.QWidget
QWidget.RenderFlag, QWidget.RenderFlags
 
Nested classes/interfaces inherited from class com.trolltech.qt.QSignalEmitter
QSignalEmitter.AbstractSignal, QSignalEmitter.PrivateSignal0, QSignalEmitter.PrivateSignal1, QSignalEmitter.PrivateSignal2, QSignalEmitter.PrivateSignal3, QSignalEmitter.PrivateSignal4, QSignalEmitter.PrivateSignal5, QSignalEmitter.PrivateSignal6, QSignalEmitter.PrivateSignal7, QSignalEmitter.PrivateSignal8, QSignalEmitter.PrivateSignal9, QSignalEmitter.Signal0, QSignalEmitter.Signal1, QSignalEmitter.Signal2, QSignalEmitter.Signal3, QSignalEmitter.Signal4, QSignalEmitter.Signal5, QSignalEmitter.Signal6, QSignalEmitter.Signal7, QSignalEmitter.Signal8, QSignalEmitter.Signal9
 
Nested classes/interfaces inherited from class com.trolltech.qt.internal.QSignalEmitterInternal
com.trolltech.qt.internal.QSignalEmitterInternal.AbstractSignalInternal
 
Field Summary
 QSignalEmitter.Signal1 dateChanged
          This signal takes 1 generic argument(s).
 QSignalEmitter.Signal1 dateTimeChanged
          This signal takes 1 generic argument(s).
 QSignalEmitter.Signal1 timeChanged
          This signal takes 1 generic argument(s).
 
Fields inherited from class com.trolltech.qt.gui.QAbstractSpinBox
editingFinished
 
Fields inherited from class com.trolltech.qt.gui.QWidget
customContextMenuRequested
 
Fields inherited from class com.trolltech.qt.internal.QSignalEmitterInternal
currentSender
 
Constructor Summary
QDateTimeEdit()
          Constructs an empty date time editor with a parent.
QDateTimeEdit(QDate d)
          Constructs an empty date time editor with a parent.
QDateTimeEdit(QDate d, QWidget parent)
           
QDateTimeEdit(QDateTime dt)
          Constructs an empty date time editor with a parent.
QDateTimeEdit(QDateTime dt, QWidget parent)
          Constructs an empty date time editor with a parent.
QDateTimeEdit(QTime t)
          Constructs an empty date time editor with a parent.
QDateTimeEdit(QTime t, QWidget parent)
          Constructs an empty date time editor with a parent.
QDateTimeEdit(QWidget parent)
          Constructs an empty date time editor with a parent.
 
Method Summary
 boolean calendarPopup()
          This property holds the current calender pop-up showing mode.
 QCalendarWidget calendarWidget()
          Returns the calendar widget for the editor if calendarPopup is set to true and (sections() & DateSections_Mask ) != 0.
 void clearMaximumDate()
          This property holds the maximum date of the date time edit.
 void clearMaximumDateTime()
          This property holds the maximum datetime of the date time edit.
 void clearMaximumTime()
          This property holds the maximum time of the date time edit.
 void clearMinimumDate()
          This property holds the minimum date of the date time edit.
 void clearMinimumDateTime()
          This property holds the minimum datetime of the date time edit.
 void clearMinimumTime()
          This property holds the minimum time of the date time edit.
 QDateTimeEdit.Section currentSection()
          This property holds the current section of the spinbox setCurrentSection().
 int currentSectionIndex()
          This property holds the current section index of the spinbox.
 QDate date()
          This property holds the QDate that is set in the QDateTimeEdit.
 QDateTime dateTime()
          This property holds the QDateTime that is set in the QDateTimeEdit.
protected  QDateTime dateTimeFromText(java.lang.String text)
          Returns an appropriate datetime for the given text.
 QDateTimeEdit.Sections displayedSections()
          This property holds the currently displayed fields of the date time edit.
 java.lang.String displayFormat()
          This property holds the format used to display the time/date of the date time edit.
protected  void initDateTimeEditStyleOption(QStyleOptionSpinBox option)
          Initializes the style option of this QDateTimeEdit.
 QDate maximumDate()
          This property holds the maximum date of the date time edit.
 QDateTime maximumDateTime()
          This property holds the maximum datetime of the date time edit.
 QTime maximumTime()
          This property holds the maximum time of the date time edit.
 QDate minimumDate()
          This property holds the minimum date of the date time edit.
 QDateTime minimumDateTime()
          This property holds the minimum datetime of the date time edit.
 QTime minimumTime()
          This property holds the minimum time of the date time edit.
 QDateTimeEdit.Section sectionAt(int index)
          Returns the Section at index.
 int sectionCount()
          This property holds the number of sections displayed.
 java.lang.String sectionText(QDateTimeEdit.Section section)
          Returns the text from the given section.
 void setCalendarPopup(boolean enable)
          This property holds the current calender pop-up showing mode.
 void setCalendarWidget(QCalendarWidget calendarWidget)
          Sets the given calendarWidget as the widget to be used for the calendar pop-up.
 void setCurrentSection(QDateTimeEdit.Section section)
          This property holds the current section of the spinbox setCurrentSection().
 void setCurrentSectionIndex(int index)
          This property holds the current section index of the spinbox.
 void setDate(QDate date)
          This property holds the QDate that is set in the QDateTimeEdit.
 void setDateRange(QDate min, QDate max)
          Convenience function to set minimum and maximum date with one function call.
 void setDateTime(QDateTime dateTime)
          This property holds the QDateTime that is set in the QDateTimeEdit.
 void setDateTimeRange(QDateTime min, QDateTime max)
          Convenience function to set minimum and maximum date time with one function call.
 void setDisplayFormat(java.lang.String format)
          This property holds the format used to display the time/date of the date time edit.
 void setMaximumDate(QDate max)
          This property holds the maximum date of the date time edit.
 void setMaximumDateTime(QDateTime dt)
          This property holds the maximum datetime of the date time edit.
 void setMaximumTime(QTime max)
          This property holds the maximum time of the date time edit.
 void setMinimumDate(QDate min)
          This property holds the minimum date of the date time edit.
 void setMinimumDateTime(QDateTime dt)
          This property holds the minimum datetime of the date time edit.
 void setMinimumTime(QTime min)
          This property holds the minimum time of the date time edit.
 void setSelectedSection(QDateTimeEdit.Section section)
          Selects section.
 void setTime(QTime time)
          This property holds the QTime that is set in the QDateTimeEdit.
 void setTimeRange(QTime min, QTime max)
          Convenience function to set minimum and maximum time with one function call.
 void setTimeSpec(Qt.TimeSpec spec)
          This property holds the current timespec used by the date time edit.
protected  java.lang.String textFromDateTime(QDateTime dt)
          This virtual function is used by the date time edit whenever it needs to display dateTime.
 QTime time()
          This property holds the QTime that is set in the QDateTimeEdit.
 Qt.TimeSpec timeSpec()
          This property holds the current timespec used by the date time edit.
 
Methods inherited from class com.trolltech.qt.gui.QAbstractSpinBox
alignment, buttonSymbols, clear, correctionMode, fixup, hasAcceptableInput, hasFrame, initStyleOption, interpretText, isAccelerated, isReadOnly, keyboardTracking, lineEdit, selectAll, setAccelerated, setAlignment, setAlignment, setButtonSymbols, setCorrectionMode, setFrame, setKeyboardTracking, setLineEdit, setReadOnly, setSpecialValueText, setWrapping, specialValueText, stepBy, stepDown, stepEnabled, stepUp, text, validate, wrapping
 
Methods inherited from class com.trolltech.qt.gui.QWidget
acceptDrops, accessibleDescription, accessibleName, actionEvent, actions, activateWindow, addAction, addActions, adjustSize, autoFillBackground, backgroundRole, baseSize, changeEvent, childAt, childAt, childrenRect, childrenRegion, clearFocus, clearMask, close, closeEvent, contentsRect, contextMenuEvent, contextMenuPolicy, cursor, depth, destroy, destroy, destroy, dragEnterEvent, dragLeaveEvent, dragMoveEvent, dropEvent, effectiveWinId, ensurePolished, enterEvent, focusInEvent, focusNextChild, focusNextPrevChild, focusOutEvent, focusPolicy, focusPreviousChild, focusProxy, focusWidget, font, fontInfo, fontMetrics, foregroundRole, frameGeometry, frameSize, geometry, getContentsMargins, grabKeyboard, grabMouse, grabMouse, grabShortcut, grabShortcut, graphicsProxyWidget, hasFocus, hasMouseTracking, height, heightForWidth, heightMM, hide, hideEvent, inputContext, inputMethodEvent, inputMethodQuery, insertAction, insertActions, isActiveWindow, isAncestorOf, isEnabled, isEnabledTo, isFullScreen, isHidden, isMaximized, isMinimized, isModal, isVisible, isVisibleTo, isWindow, isWindowModified, keyboardGrabber, keyPressEvent, keyReleaseEvent, languageChange, layout, layoutDirection, leaveEvent, locale, logicalDpiX, logicalDpiY, lower, mapFrom, mapFromGlobal, mapFromParent, mapTo, mapToGlobal, mapToParent, mask, maximumHeight, maximumSize, maximumWidth, metric, minimumHeight, minimumSize, minimumSizeHint, minimumWidth, mouseDoubleClickEvent, mouseGrabber, mouseMoveEvent, mousePressEvent, mouseReleaseEvent, move, move, moveEvent, nativeParentWidget, nextInFocusChain, normalGeometry, numColors, overrideWindowFlags, overrideWindowFlags, overrideWindowState, paintEngine, paintEvent, paintingActive, palette, parentWidget, physicalDpiX, physicalDpiY, pos, raise, rect, releaseKeyboard, releaseMouse, releaseShortcut, removeAction, render, render, render, render, render, render, render, render, render, repaint, repaint, repaint, repaint, resetInputContext, resize, resize, resizeEvent, restoreGeometry, saveGeometry, scroll, scroll, setAcceptDrops, setAccessibleDescription, setAccessibleName, setAttribute, setAttribute, setAutoFillBackground, setBackgroundRole, setBaseSize, setBaseSize, setContentsMargins, setContentsMargins, setContextMenuPolicy, setCursor, setDisabled, setEnabled, setFixedHeight, setFixedSize, setFixedSize, setFixedWidth, setFocus, setFocus, setFocusPolicy, setFocusProxy, setFont, setForegroundRole, setGeometry, setGeometry, setHidden, setInputContext, setLayout, setLayoutDirection, setLocale, setMask, setMask, setMaximumHeight, setMaximumSize, setMaximumSize, setMaximumWidth, setMinimumHeight, setMinimumSize, setMinimumSize, setMinimumWidth, setMouseTracking, setPalette, setParent, setParent, setParent, setShortcutAutoRepeat, setShortcutAutoRepeat, setShortcutEnabled, setShortcutEnabled, setSizeIncrement, setSizeIncrement, setSizePolicy, setSizePolicy, setStatusTip, setStyle, setStyleSheet, setTabOrder, setToolTip, setUpdatesEnabled, setVisible, setWhatsThis, setWindowFilePath, setWindowFlags, setWindowFlags, setWindowIcon, setWindowIconText, setWindowModality, setWindowModified, setWindowOpacity, setWindowRole, setWindowState, setWindowState, setWindowTitle, show, showEvent, showFullScreen, showMaximized, showMinimized, showNormal, size, sizeHint, sizeIncrement, sizePolicy, stackUnder, statusTip, style, styleSheet, tabletEvent, testAttribute, toolTip, underMouse, unsetCursor, unsetLayoutDirection, unsetLocale, update, update, update, update, updateGeometry, updateMicroFocus, updatesEnabled, visibleRegion, whatsThis, wheelEvent, width, widthMM, window, windowFilePath, windowFlags, windowIcon, windowIconText, windowModality, windowOpacity, windowRole, windowState, windowTitle, windowType, winId, x, y
 
Methods inherited from class com.trolltech.qt.core.QObject
childEvent, children, connectSlotsByName, customEvent, disposeLater, dumpObjectInfo, dumpObjectTree, dynamicPropertyNames, event, eventFilter, findChild, findChild, findChild, findChildren, findChildren, findChildren, findChildren, indexOfProperty, installEventFilter, isWidgetType, killTimer, moveToThread, objectName, parent, properties, property, removeEventFilter, setObjectName, setParent, setProperty, startTimer, timerEvent, toString, userProperty
 
Methods inherited from class com.trolltech.qt.QtJambiObject
dispose, disposed, equals, finalize, reassignNativeResources, tr, tr, tr
 
Methods inherited from class com.trolltech.qt.QSignalEmitter
blockSignals, disconnect, disconnect, signalsBlocked, signalSender, thread
 
Methods inherited from class com.trolltech.qt.internal.QSignalEmitterInternal
__qt_signalInitialization
 
Methods inherited from class java.lang.Object
clone, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface com.trolltech.qt.QtJambiInterface
disableGarbageCollection, nativeId, nativePointer, reenableGarbageCollection, setJavaOwnership
 

Field Detail

dateChanged

public final QSignalEmitter.Signal1 dateChanged

This signal takes 1 generic argument(s). We list their type and the name they go by in the description of this signal. <com.trolltech.qt.core.QDate(named: date)>:

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


dateTimeChanged

public final QSignalEmitter.Signal1 dateTimeChanged

This signal takes 1 generic argument(s). We list their type and the name they go by in the description of this signal. <com.trolltech.qt.core.QDateTime(named: datetime)>:

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


timeChanged

public final QSignalEmitter.Signal1 timeChanged

This signal takes 1 generic argument(s). We list their type and the name they go by in the description of this signal. <com.trolltech.qt.core.QTime(named: time)>:

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

Constructor Detail

QDateTimeEdit

public QDateTimeEdit()
Constructs an empty date time editor with a parent.


QDateTimeEdit

public QDateTimeEdit(QWidget parent)
Constructs an empty date time editor with a parent.


QDateTimeEdit

public QDateTimeEdit(QDate d)
Constructs an empty date time editor with a parent. The value is set to date.


QDateTimeEdit

public QDateTimeEdit(QDate d,
                     QWidget parent)

QDateTimeEdit

public QDateTimeEdit(QDateTime dt)
Constructs an empty date time editor with a parent. The value is set to datetime.


QDateTimeEdit

public QDateTimeEdit(QDateTime dt,
                     QWidget parent)
Constructs an empty date time editor with a parent. The value is set to date.


QDateTimeEdit

public QDateTimeEdit(QTime t)
Constructs an empty date time editor with a parent. The value is set to time.


QDateTimeEdit

public QDateTimeEdit(QTime t,
                     QWidget parent)
Constructs an empty date time editor with a parent. The value is set to time.

Method Detail

calendarPopup

public final boolean calendarPopup()
This property holds the current calender pop-up showing mode. The calendar pop-up will be shown upon clicking the arrow button. This property is valid only if there is a valid date display format.

See also:
setDisplayFormat().


calendarWidget

public final QCalendarWidget calendarWidget()
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().


clearMaximumDate

public final void clearMaximumDate()
This property holds the maximum date of the date time edit. When setting this property the minimumDate is adjusted if necessary to ensure that the range remains valid. If the date is not a valid QDate object, this function does nothing.

By default, this property contains a date that refers to December 31, 7999.

See also:
minimumDate, minimumTime, maximumTime, and setDateRange().


clearMaximumDateTime

public final void clearMaximumDateTime()
This property holds the maximum datetime of the date time edit. When setting this property the minimumDateTime() is adjusted if necessary to ensure that the range remains valid. If the datetime is not a valid QDateTime object, this function does nothing.

The default maximumDateTime can be restored with clearMaximumDateTime().

By default, this property contains a date that refers to 31 December, 7999 and a time of 23:59:59 and 999 milliseconds.

See also:
minimumDateTime(), minimumTime(), maximumTime(), minimumDate(), maximumDate(), setDateTimeRange(), setDateRange(), setTimeRange(), clearMinimumDateTime(), clearMinimumDate(), clearMaximumDate(), clearMinimumTime(), and clearMaximumTime().


clearMaximumTime

public final void clearMaximumTime()
This property holds the maximum time of the date time edit. When setting this property, the minimumTime is adjusted if necessary to ensure that the range remains valid. If the time is not a valid QTime object, this function does nothing.

By default, this property contains a time of 23:59:59 and 999 milliseconds.

See also:
minimumTime, minimumDate, maximumDate, and setTimeRange().


clearMinimumDate

public final void clearMinimumDate()
This property holds the minimum date of the date time edit. When setting this property the maximumDate is adjusted if necessary, to ensure that the range remains valid. If the date is not a valid QDate object, this function does nothing.

By default, this property contains a date that refers to September 14, 1752. The minimum date must be at least the first day in year 100, otherwise setMinimumDate() has no effect.

See also:
minimumTime(), maximumTime(), and setDateRange().


clearMinimumDateTime

public final void clearMinimumDateTime()
This property holds the minimum datetime of the date time edit. When setting this property the maximumDateTime() is adjusted if necessary to ensure that the range remains valid. If the datetime is not a valid QDateTime object, this function does nothing.

The default minimumDateTime can be restored with clearMinimumDateTime()

By default, this property contains a date that refers to September 14, 1752 and a time of 00:00:00 and 0 milliseconds.

See also:
maximumDateTime(), minimumTime(), maximumTime(), minimumDate(), maximumDate(), setDateTimeRange(), setDateRange(), setTimeRange(), clearMaximumDateTime(), clearMinimumDate(), clearMaximumDate(), clearMinimumTime(), and clearMaximumTime().


clearMinimumTime

public final void clearMinimumTime()
This property holds the minimum time of the date time edit. When setting this property the maximumTime is adjusted if necessary, to ensure that the range remains valid. If the time is not a valid QTime object, this function does nothing.

By default, this property contains a time of 00:00:00 and 0 milliseconds.

See also:
maximumTime, minimumDate, maximumDate, and setTimeRange().


currentSection

public final QDateTimeEdit.Section currentSection()
This property holds the current section of the spinbox setCurrentSection().


currentSectionIndex

public final int currentSectionIndex()
This property holds the current section index of the spinbox. If the format is 'yyyy/MM/dd', the displayText is '2001/05/21' and the cursorPosition is 5 currentSectionIndex returns 1. If the cursorPosition is 3 currentSectionIndex is 0 etc.

setCurrentSection()

See also:
currentSection().


date

public final QDate date()
This property holds the QDate that is set in the QDateTimeEdit. By default, this property contains a date that refers to January 1, 2000.

See also:
time, and dateTime.


dateTime

public final QDateTime dateTime()
This property holds the QDateTime that is set in the QDateTimeEdit. By default, this property contains a date that refers to January 1, 2000 and a time of 00:00:00 and 0 milliseconds.

See also:
date, and time.


displayFormat

public final java.lang.String displayFormat()
This property holds the format used to display the time/date of the date time edit. This format is the same as the one used described in QDateTime::toString() and QDateTime::fromString()

Example format strings(assuming that the date is 2nd of July 1969):

Format
Result
dd.MM.yyyy 02.07.1969
MMM d yy Jul 2 69
MMMM d yy July 2 69
Note that if you specify a two digit year, it will be interpreted to be in the century in which the date time edit was initialized. The default century is the 21 (2000-2099).

If you specify an invalid format the format will not be set.

See also:
QDateTime::toString(), and displayedSections().


displayedSections

public final QDateTimeEdit.Sections displayedSections()
This property holds the currently displayed fields of the date time edit. Returns a bit set of the displayed sections for this format. setDisplayFormat(), displayFormat()


maximumDate

public final QDate maximumDate()
This property holds the maximum date of the date time edit. When setting this property the minimumDate is adjusted if necessary to ensure that the range remains valid. If the date is not a valid QDate object, this function does nothing.

By default, this property contains a date that refers to December 31, 7999.

See also:
minimumDate, minimumTime, maximumTime, and setDateRange().


maximumDateTime

public final QDateTime maximumDateTime()
This property holds the maximum datetime of the date time edit. When setting this property the minimumDateTime() is adjusted if necessary to ensure that the range remains valid. If the datetime is not a valid QDateTime object, this function does nothing.

The default maximumDateTime can be restored with clearMaximumDateTime().

By default, this property contains a date that refers to 31 December, 7999 and a time of 23:59:59 and 999 milliseconds.

See also:
minimumDateTime(), minimumTime(), maximumTime(), minimumDate(), maximumDate(), setDateTimeRange(), setDateRange(), setTimeRange(), clearMinimumDateTime(), clearMinimumDate(), clearMaximumDate(), clearMinimumTime(), and clearMaximumTime().


maximumTime

public final QTime maximumTime()
This property holds the maximum time of the date time edit. When setting this property, the minimumTime is adjusted if necessary to ensure that the range remains valid. If the time is not a valid QTime object, this function does nothing.

By default, this property contains a time of 23:59:59 and 999 milliseconds.

See also:
minimumTime, minimumDate, maximumDate, and setTimeRange().


minimumDate

public final QDate minimumDate()
This property holds the minimum date of the date time edit. When setting this property the maximumDate is adjusted if necessary, to ensure that the range remains valid. If the date is not a valid QDate object, this function does nothing.

By default, this property contains a date that refers to September 14, 1752. The minimum date must be at least the first day in year 100, otherwise setMinimumDate() has no effect.

See also:
minimumTime(), maximumTime(), and setDateRange().


minimumDateTime

public final QDateTime minimumDateTime()
This property holds the minimum datetime of the date time edit. When setting this property the maximumDateTime() is adjusted if necessary to ensure that the range remains valid. If the datetime is not a valid QDateTime object, this function does nothing.

The default minimumDateTime can be restored with clearMinimumDateTime()

By default, this property contains a date that refers to September 14, 1752 and a time of 00:00:00 and 0 milliseconds.

See also:
maximumDateTime(), minimumTime(), maximumTime(), minimumDate(), maximumDate(), setDateTimeRange(), setDateRange(), setTimeRange(), clearMaximumDateTime(), clearMinimumDate(), clearMaximumDate(), clearMinimumTime(), and clearMaximumTime().


minimumTime

public final QTime minimumTime()
This property holds the minimum time of the date time edit. When setting this property the maximumTime is adjusted if necessary, to ensure that the range remains valid. If the time is not a valid QTime object, this function does nothing.

By default, this property contains a time of 00:00:00 and 0 milliseconds.

See also:
maximumTime, minimumDate, maximumDate, and setTimeRange().


sectionAt

public final QDateTimeEdit.Section sectionAt(int index)
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 ,


sectionCount

public final int sectionCount()
This property holds the number of sections displayed. If the format is 'yyyy/yy/yyyy', sectionCount returns 3.


sectionText

public final java.lang.String sectionText(QDateTimeEdit.Section section)
Returns the text from the given section.

See also:
currentSection().


setCalendarPopup

public final void setCalendarPopup(boolean enable)
This property holds the current calender pop-up showing mode. The calendar pop-up will be shown upon clicking the arrow button. This property is valid only if there is a valid date display format.

See also:
setDisplayFormat().


setCalendarWidget

public final void 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.


setCurrentSection

public final void setCurrentSection(QDateTimeEdit.Section section)
This property holds the current section of the spinbox setCurrentSection().


setCurrentSectionIndex

public final void setCurrentSectionIndex(int index)
This property holds the current section index of the spinbox. If the format is 'yyyy/MM/dd', the displayText is '2001/05/21' and the cursorPosition is 5 currentSectionIndex returns 1. If the cursorPosition is 3 currentSectionIndex is 0 etc.

setCurrentSection()

See also:
currentSection().


setDate

public final void setDate(QDate date)
This property holds the QDate that is set in the QDateTimeEdit. By default, this property contains a date that refers to January 1, 2000.

See also:
time, and dateTime.


setDateRange

public final void setDateRange(QDate min,
                               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().


setDateTime

public final void setDateTime(QDateTime dateTime)
This property holds the QDateTime that is set in the QDateTimeEdit. By default, this property contains a date that refers to January 1, 2000 and a time of 00:00:00 and 0 milliseconds.

See also:
date, and time.


setDateTimeRange

public final void setDateTimeRange(QDateTime min,
                                   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.

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


setDisplayFormat

public final void setDisplayFormat(java.lang.String format)
This property holds the format used to display the time/date of the date time edit. This format is the same as the one used described in QDateTime::toString() and QDateTime::fromString()

Example format strings(assuming that the date is 2nd of July 1969):

Format
Result
dd.MM.yyyy 02.07.1969
MMM d yy Jul 2 69
MMMM d yy July 2 69
Note that if you specify a two digit year, it will be interpreted to be in the century in which the date time edit was initialized. The default century is the 21 (2000-2099).

If you specify an invalid format the format will not be set.

See also:
QDateTime::toString(), and displayedSections().


setMaximumDate

public final void setMaximumDate(QDate max)
This property holds the maximum date of the date time edit. When setting this property the minimumDate is adjusted if necessary to ensure that the range remains valid. If the date is not a valid QDate object, this function does nothing.

By default, this property contains a date that refers to December 31, 7999.

See also:
minimumDate, minimumTime, maximumTime, and setDateRange().


setMaximumDateTime

public final void setMaximumDateTime(QDateTime dt)
This property holds the maximum datetime of the date time edit. When setting this property the minimumDateTime() is adjusted if necessary to ensure that the range remains valid. If the datetime is not a valid QDateTime object, this function does nothing.

The default maximumDateTime can be restored with clearMaximumDateTime().

By default, this property contains a date that refers to 31 December, 7999 and a time of 23:59:59 and 999 milliseconds.

See also:
minimumDateTime(), minimumTime(), maximumTime(), minimumDate(), maximumDate(), setDateTimeRange(), setDateRange(), setTimeRange(), clearMinimumDateTime(), clearMinimumDate(), clearMaximumDate(), clearMinimumTime(), and clearMaximumTime().


setMaximumTime

public final void setMaximumTime(QTime max)
This property holds the maximum time of the date time edit. When setting this property, the minimumTime is adjusted if necessary to ensure that the range remains valid. If the time is not a valid QTime object, this function does nothing.

By default, this property contains a time of 23:59:59 and 999 milliseconds.

See also:
minimumTime, minimumDate, maximumDate, and setTimeRange().


setMinimumDate

public final void setMinimumDate(QDate min)
This property holds the minimum date of the date time edit. When setting this property the maximumDate is adjusted if necessary, to ensure that the range remains valid. If the date is not a valid QDate object, this function does nothing.

By default, this property contains a date that refers to September 14, 1752. The minimum date must be at least the first day in year 100, otherwise setMinimumDate() has no effect.

See also:
minimumTime(), maximumTime(), and setDateRange().


setMinimumDateTime

public final void setMinimumDateTime(QDateTime dt)
This property holds the minimum datetime of the date time edit. When setting this property the maximumDateTime() is adjusted if necessary to ensure that the range remains valid. If the datetime is not a valid QDateTime object, this function does nothing.

The default minimumDateTime can be restored with clearMinimumDateTime()

By default, this property contains a date that refers to September 14, 1752 and a time of 00:00:00 and 0 milliseconds.

See also:
maximumDateTime(), minimumTime(), maximumTime(), minimumDate(), maximumDate(), setDateTimeRange(), setDateRange(), setTimeRange(), clearMaximumDateTime(), clearMinimumDate(), clearMaximumDate(), clearMinimumTime(), and clearMaximumTime().


setMinimumTime

public final void setMinimumTime(QTime min)
This property holds the minimum time of the date time edit. When setting this property the maximumTime is adjusted if necessary, to ensure that the range remains valid. If the time is not a valid QTime object, this function does nothing.

By default, this property contains a time of 00:00:00 and 0 milliseconds.

See also:
maximumTime, minimumDate, maximumDate, and setTimeRange().


setSelectedSection

public final void 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().


setTime

public final void setTime(QTime time)
This property holds the QTime that is set in the QDateTimeEdit. By default, this property contains a time of 00:00:00 and 0 milliseconds.

See also:
date, and dateTime.


setTimeRange

public final void setTimeRange(QTime min,
                               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().


setTimeSpec

public final void setTimeSpec(Qt.TimeSpec spec)
This property holds the current timespec used by the date time edit. All dates/passed to the date time edit will be converted to this timespec.


time

public final QTime time()
This property holds the QTime that is set in the QDateTimeEdit. By default, this property contains a time of 00:00:00 and 0 milliseconds.

See also:
date, and dateTime.


timeSpec

public final Qt.TimeSpec timeSpec()
This property holds the current timespec used by the date time edit. All dates/passed to the date time edit will be converted to this timespec.


dateTimeFromText

protected QDateTime dateTimeFromText(java.lang.String text)
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().


textFromDateTime

protected java.lang.String textFromDateTime(QDateTime dt)
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().


initDateTimeEditStyleOption

protected final void initDateTimeEditStyleOption(QStyleOptionSpinBox option)
Initializes the style option of this QDateTimeEdit.