QtBase  v6.3.1
Public Types | Public Slots | Signals | Public Member Functions | Protected Member Functions | Properties | List of all members
QDateTimeEdit Class Reference

The QDateTimeEdit class provides a widget for editing dates and times. More...

#include <qdatetimeedit.h>

Inheritance diagram for QDateTimeEdit:
Inheritance graph
[legend]
Collaboration diagram for QDateTimeEdit:
Collaboration graph
[legend]

Public Types

enum  Section {
  NoSection = 0x0000 , AmPmSection = 0x0001 , MSecSection = 0x0002 , SecondSection = 0x0004 ,
  MinuteSection = 0x0008 , HourSection = 0x0010 , DaySection = 0x0100 , MonthSection = 0x0200 ,
  YearSection = 0x0400 , TimeSections_Mask = AmPmSection|MSecSection|SecondSection|MinuteSection|HourSection , DateSections_Mask = DaySection|MonthSection|YearSection
}
 
- Public Types inherited from QAbstractSpinBox
enum  StepEnabledFlag { StepNone = 0x00 , StepUpEnabled = 0x01 , StepDownEnabled = 0x02 }
 
enum  ButtonSymbols { UpDownArrows , PlusMinus , NoButtons }
 
enum  CorrectionMode { CorrectToPreviousValue , CorrectToNearestValue }
 
enum  StepType { DefaultStepType , AdaptiveDecimalStepType }
 
- Public Types inherited from QWidget
enum  RenderFlag { DrawWindowBackground = 0x1 , DrawChildren = 0x2 , IgnoreMask = 0x4 }
 
- Public Types inherited from QPaintDevice
enum  PaintDeviceMetric {
  PdmWidth = 1 , PdmHeight , PdmWidthMM , PdmHeightMM ,
  PdmNumColors , PdmDepth , PdmDpiX , PdmDpiY ,
  PdmPhysicalDpiX , PdmPhysicalDpiY , PdmDevicePixelRatio , PdmDevicePixelRatioScaled
}
 

Public Slots

void setDateTime (const QDateTime &dateTime)
 
void setDate (QDate date)
 
void setTime (QTime time)
 
- Public Slots inherited from QAbstractSpinBox
void stepUp ()
 
void stepDown ()
 
void selectAll ()
 
- Public Slots inherited from QWidget
void setEnabled (bool)
 
void setDisabled (bool)
 
void setWindowModified (bool)
 
void setWindowTitle (const QString &)
 
void setStyleSheet (const QString &styleSheet)
 
void setFocus ()
 
void update ()
 
void repaint ()
 
virtual void setVisible (bool visible)
 
void setHidden (bool hidden)
 
void show ()
 
void hide ()
 
void showMinimized ()
 
void showMaximized ()
 
void showFullScreen ()
 
void showNormal ()
 
bool close ()
 
void raise ()
 
void lower ()
 
- Public Slots inherited from QObject
void deleteLater ()
 

Signals

void dateTimeChanged (const QDateTime &dateTime)
 
void timeChanged (QTime time)
 
void dateChanged (QDate date)
 
- Signals inherited from QAbstractSpinBox
void editingFinished ()
 
- Signals inherited from QWidget
void windowTitleChanged (const QString &title)
 
void windowIconChanged (const QIcon &icon)
 
void windowIconTextChanged (const QString &iconText)
 
void customContextMenuRequested (const QPoint &pos)
 
- Signals inherited from QObject
void destroyed (QObject *=nullptr)
 
void objectNameChanged (const QString &objectName, QPrivateSignal)
 

Public Member Functions

 QDateTimeEdit (QWidget *parent=nullptr)
 
 QDateTimeEdit (const QDateTime &dt, QWidget *parent=nullptr)
 
 QDateTimeEdit (QDate d, QWidget *parent=nullptr)
 
 QDateTimeEdit (QTime t, QWidget *parent=nullptr)
 
 ~QDateTimeEdit ()
 
QDateTime dateTime () const
 
QDate date () const
 
QTime time () const
 
QCalendar calendar () const
 
void setCalendar (QCalendar calendar)
 
QDateTime minimumDateTime () const
 
void clearMinimumDateTime ()
 
void setMinimumDateTime (const QDateTime &dt)
 
QDateTime maximumDateTime () const
 
void clearMaximumDateTime ()
 
void setMaximumDateTime (const QDateTime &dt)
 
void setDateTimeRange (const QDateTime &min, const QDateTime &max)
 Set the range of allowed date-times for the date time edit. More...
 
QDate minimumDate () const
 
void setMinimumDate (QDate min)
 
void clearMinimumDate ()
 
QDate maximumDate () const
 
void setMaximumDate (QDate max)
 
void clearMaximumDate ()
 
void setDateRange (QDate min, QDate max)
 Set the range of allowed dates for the date time edit. More...
 
QTime minimumTime () const
 
void setMinimumTime (QTime min)
 
void clearMinimumTime ()
 
QTime maximumTime () const
 
void setMaximumTime (QTime max)
 
void clearMaximumTime ()
 
void setTimeRange (QTime min, QTime max)
 Set the range of allowed times for the date time edit. More...
 
Sections displayedSections () const
 
Section currentSection () const
 
Section sectionAt (int index) const
 
void setCurrentSection (Section section)
 
int currentSectionIndex () const
 
void setCurrentSectionIndex (int index)
 
QCalendarWidgetcalendarWidget () const
 Returns the calendar widget for the editor if calendarPopup is set to true and (sections() & DateSections_Mask) != 0. More...
 
void setCalendarWidget (QCalendarWidget *calendarWidget)
 
int sectionCount () const
 
void setSelectedSection (Section section)
 
QString sectionText (Section section) const
 
QString displayFormat () const
 
void setDisplayFormat (const QString &format)
 
bool calendarPopup () const
 
void setCalendarPopup (bool enable)
 
Qt::TimeSpec timeSpec () const
 
void setTimeSpec (Qt::TimeSpec spec)
 
QSize sizeHint () const override
 
void clear () override
 
void stepBy (int steps) override
 
bool event (QEvent *event) override
 
- Public Member Functions inherited from QAbstractSpinBox
 QAbstractSpinBox (QWidget *parent=nullptr)
 
 ~QAbstractSpinBox ()
 
ButtonSymbols buttonSymbols () const
 
void setButtonSymbols (ButtonSymbols bs)
 
void setCorrectionMode (CorrectionMode cm)
 
CorrectionMode correctionMode () const
 
bool hasAcceptableInput () const
 
QString text () const
 
QString specialValueText () const
 
void setSpecialValueText (const QString &txt)
 
bool wrapping () const
 
void setWrapping (bool w)
 
void setReadOnly (bool r)
 
bool isReadOnly () const
 
void setKeyboardTracking (bool kt)
 
bool keyboardTracking () const
 
void setAlignment (Qt::Alignment flag)
 
Qt::Alignment alignment () const
 
void setFrame (bool)
 
bool hasFrame () const
 
void setAccelerated (bool on)
 
bool isAccelerated () const
 
void setGroupSeparatorShown (bool shown)
 
bool isGroupSeparatorShown () const
 
QSize minimumSizeHint () const override
 
void interpretText ()
 
QVariant inputMethodQuery (Qt::InputMethodQuery) const override
 
- Public Member Functions inherited from QWidget
 QWidget (QWidget *parent=nullptr, Qt::WindowFlags f=Qt::WindowFlags())
 
 ~QWidget ()
 
int devType () const override
 
WId winId () const
 
void createWinId ()
 
WId internalWinId () const
 
WId effectiveWinId () const
 
QStylestyle () const
 
void setStyle (QStyle *)
 
bool isWindow () const
 
bool isModal () const
 
Qt::WindowModality windowModality () const
 
void setWindowModality (Qt::WindowModality windowModality)
 
bool isEnabled () const
 
bool isEnabledTo (const QWidget *) const
 
QRect frameGeometry () const
 
const QRectgeometry () const
 
QRect normalGeometry () const
 
int x () const
 
int y () const
 
QPoint pos () const
 
QSize frameSize () const
 
QSize size () const
 
int width () const
 
int height () const
 
QRect rect () const
 
QRect childrenRect () const
 
QRegion childrenRegion () const
 
QSize minimumSize () const
 
QSize maximumSize () const
 
int minimumWidth () const
 
int minimumHeight () const
 
int maximumWidth () const
 
int maximumHeight () const
 
void setMinimumSize (const QSize &)
 
void setMinimumSize (int minw, int minh)
 
void setMaximumSize (const QSize &)
 
void setMaximumSize (int maxw, int maxh)
 
void setMinimumWidth (int minw)
 
void setMinimumHeight (int minh)
 
void setMaximumWidth (int maxw)
 
void setMaximumHeight (int maxh)
 
QSize sizeIncrement () const
 
void setSizeIncrement (const QSize &)
 
void setSizeIncrement (int w, int h)
 
QSize baseSize () const
 
void setBaseSize (const QSize &)
 
void setBaseSize (int basew, int baseh)
 
void setFixedSize (const QSize &)
 
void setFixedSize (int w, int h)
 
void setFixedWidth (int w)
 
void setFixedHeight (int h)
 
QPointF mapToGlobal (const QPointF &) const
 
QPoint mapToGlobal (const QPoint &) const
 
QPointF mapFromGlobal (const QPointF &) const
 
QPoint mapFromGlobal (const QPoint &) const
 
QPointF mapToParent (const QPointF &) const
 
QPoint mapToParent (const QPoint &) const
 
QPointF mapFromParent (const QPointF &) const
 
QPoint mapFromParent (const QPoint &) const
 
QPointF mapTo (const QWidget *, const QPointF &) const
 
QPoint mapTo (const QWidget *, const QPoint &) const
 
QPointF mapFrom (const QWidget *, const QPointF &) const
 
QPoint mapFrom (const QWidget *, const QPoint &) const
 
QWidgetwindow () const
 
QWidgetnativeParentWidget () const
 
QWidgettopLevelWidget () const
 
const QPalettepalette () const
 
void setPalette (const QPalette &)
 
void setBackgroundRole (QPalette::ColorRole)
 
QPalette::ColorRole backgroundRole () const
 
void setForegroundRole (QPalette::ColorRole)
 
QPalette::ColorRole foregroundRole () const
 
const QFontfont () const
 
void setFont (const QFont &)
 
QFontMetrics fontMetrics () const
 
QFontInfo fontInfo () const
 
QCursor cursor () const
 
void setCursor (const QCursor &)
 
void unsetCursor ()
 
void setMouseTracking (bool enable)
 
bool hasMouseTracking () const
 
bool underMouse () const
 
void setTabletTracking (bool enable)
 
bool hasTabletTracking () const
 
void setMask (const QBitmap &)
 
void setMask (const QRegion &)
 
QRegion mask () const
 
void clearMask ()
 
void render (QPaintDevice *target, const QPoint &targetOffset=QPoint(), const QRegion &sourceRegion=QRegion(), RenderFlags renderFlags=RenderFlags(DrawWindowBackground|DrawChildren))
 
void render (QPainter *painter, const QPoint &targetOffset=QPoint(), const QRegion &sourceRegion=QRegion(), RenderFlags renderFlags=RenderFlags(DrawWindowBackground|DrawChildren))
 
Q_INVOKABLE QPixmap grab (const QRect &rectangle=QRect(QPoint(0, 0), QSize(-1, -1)))
 
void grabGesture (Qt::GestureType type, Qt::GestureFlags flags=Qt::GestureFlags())
 
void ungrabGesture (Qt::GestureType type)
 
QString styleSheet () const
 
QString windowTitle () const
 
void setWindowIcon (const QIcon &icon)
 
QIcon windowIcon () const
 
void setWindowIconText (const QString &)
 
QString windowIconText () const
 
void setWindowRole (const QString &)
 
QString windowRole () const
 
void setWindowFilePath (const QString &filePath)
 
QString windowFilePath () const
 
void setWindowOpacity (qreal level)
 
qreal windowOpacity () const
 
bool isWindowModified () const
 
QString accessibleName () const
 
void setAccessibleName (const QString &name)
 
QString accessibleDescription () const
 
void setAccessibleDescription (const QString &description)
 
void setLayoutDirection (Qt::LayoutDirection direction)
 
Qt::LayoutDirection layoutDirection () const
 
void unsetLayoutDirection ()
 
void setLocale (const QLocale &locale)
 
QLocale locale () const
 
void unsetLocale ()
 
bool isRightToLeft () const
 
bool isLeftToRight () const
 
bool isActiveWindow () const
 
void activateWindow ()
 
void clearFocus ()
 
void setFocus (Qt::FocusReason reason)
 
Qt::FocusPolicy focusPolicy () const
 
void setFocusPolicy (Qt::FocusPolicy policy)
 
bool hasFocus () const
 
void setFocusProxy (QWidget *)
 
QWidgetfocusProxy () const
 
Qt::ContextMenuPolicy contextMenuPolicy () const
 
void setContextMenuPolicy (Qt::ContextMenuPolicy policy)
 
void grabMouse ()
 
void grabMouse (const QCursor &)
 
void releaseMouse ()
 
void grabKeyboard ()
 
void releaseKeyboard ()
 
int grabShortcut (const QKeySequence &key, Qt::ShortcutContext context=Qt::WindowShortcut)
 
void releaseShortcut (int id)
 
void setShortcutEnabled (int id, bool enable=true)
 
void setShortcutAutoRepeat (int id, bool enable=true)
 
bool updatesEnabled () const
 
void setUpdatesEnabled (bool enable)
 
void update (int x, int y, int w, int h)
 
void update (const QRect &)
 
void update (const QRegion &)
 
void repaint (int x, int y, int w, int h)
 
void repaint (const QRect &)
 
void repaint (const QRegion &)
 
void stackUnder (QWidget *)
 
void move (int x, int y)
 
void move (const QPoint &)
 
void resize (int w, int h)
 
void resize (const QSize &)
 
void setGeometry (int x, int y, int w, int h)
 
void setGeometry (const QRect &)
 
QByteArray saveGeometry () const
 
bool restoreGeometry (const QByteArray &geometry)
 
void adjustSize ()
 
bool isVisible () const
 
bool isVisibleTo (const QWidget *) const
 
bool isHidden () const
 
bool isMinimized () const
 
bool isMaximized () const
 
bool isFullScreen () const
 
Qt::WindowStates windowState () const
 
void setWindowState (Qt::WindowStates state)
 
void overrideWindowState (Qt::WindowStates state)
 
QSizePolicy sizePolicy () const
 
void setSizePolicy (QSizePolicy)
 
void setSizePolicy (QSizePolicy::Policy horizontal, QSizePolicy::Policy vertical)
 
virtual int heightForWidth (int) const
 
virtual bool hasHeightForWidth () const
 
QRegion visibleRegion () const
 
void setContentsMargins (int left, int top, int right, int bottom)
 
void setContentsMargins (const QMargins &margins)
 The setContentsMargins function sets the margins around the widget's contents. More...
 
QMargins contentsMargins () const
 The contentsMargins function returns the widget's contents margins. More...
 
QRect contentsRect () const
 
QLayoutlayout () const
 
void setLayout (QLayout *)
 
void updateGeometry ()
 
void setParent (QWidget *parent)
 
void setParent (QWidget *parent, Qt::WindowFlags f)
 
void scroll (int dx, int dy)
 
void scroll (int dx, int dy, const QRect &)
 
QWidgetfocusWidget () const
 
QWidgetnextInFocusChain () const
 
QWidgetpreviousInFocusChain () const
 The previousInFocusChain function returns the previous widget in this widget's focus chain. More...
 
bool acceptDrops () const
 
void setAcceptDrops (bool on)
 
void addAction (QAction *action)
 
void addActions (const QList< QAction * > &actions)
 
void insertActions (QAction *before, const QList< QAction * > &actions)
 
void insertAction (QAction *before, QAction *action)
 
void removeAction (QAction *action)
 
QList< QAction * > actions () const
 
QActionaddAction (const QString &text)
 
QActionaddAction (const QIcon &icon, const QString &text)
 
QActionaddAction (const QString &text, const QObject *receiver, const char *member, Qt::ConnectionType type=Qt::AutoConnection)
 
QActionaddAction (const QIcon &icon, const QString &text, const QObject *receiver, const char *member, Qt::ConnectionType type=Qt::AutoConnection)
 
template<typename... Args, typename = compatible_action_slot_args<Args...>>
QActionaddAction (const QString &text, Args &&...args)
 
template<typename... Args, typename = compatible_action_slot_args<Args...>>
QActionaddAction (const QIcon &icon, const QString &text, Args &&...args)
 
QWidgetparentWidget () const
 
void setWindowFlags (Qt::WindowFlags type)
 
Qt::WindowFlags windowFlags () const
 
void setWindowFlag (Qt::WindowType, bool on=true)
 
void overrideWindowFlags (Qt::WindowFlags type)
 
Qt::WindowType windowType () const
 
QWidgetchildAt (int x, int y) const
 
QWidgetchildAt (const QPoint &p) const
 
void setAttribute (Qt::WidgetAttribute, bool on=true)
 
bool testAttribute (Qt::WidgetAttribute) const
 
QPaintEnginepaintEngine () const override
 
void ensurePolished () const
 
bool isAncestorOf (const QWidget *child) const
 
bool autoFillBackground () const
 
void setAutoFillBackground (bool enabled)
 
QBackingStorebackingStore () const
 
QWindowwindowHandle () const
 
QScreenscreen () const
 
void setScreen (QScreen *)
 
Qt::InputMethodHints inputMethodHints () const
 
void setInputMethodHints (Qt::InputMethodHints hints)
 
- Public Member Functions inherited from QObject
Q_INVOKABLE QObject (QObject *parent=nullptr)
 
virtual ~QObject ()
 
virtual bool eventFilter (QObject *watched, QEvent *event)
 
QString objectName () const
 
void setObjectName (const QString &name)
 
QBindable< QStringbindableObjectName ()
 
bool isWidgetType () const
 
bool isWindowType () const
 
bool signalsBlocked () const noexcept
 
bool blockSignals (bool b) noexcept
 
QThreadthread () const
 
void moveToThread (QThread *thread)
 
int startTimer (int interval, Qt::TimerType timerType=Qt::CoarseTimer)
 
void killTimer (int id)
 
template<typename T >
T findChild (const QString &aName=QString(), Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
 
template<typename T >
QList< TfindChildren (const QString &aName, Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
 
template<typename T >
QList< TfindChildren (Qt::FindChildOptions options=Qt::FindChildrenRecursively) const
 
const QObjectListchildren () const
 
void setParent (QObject *parent)
 
void installEventFilter (QObject *filterObj)
 
void removeEventFilter (QObject *obj)
 
QMetaObject::Connection connect (const QObject *sender, const char *signal, const char *member, Qt::ConnectionType type=Qt::AutoConnection) const
 
bool disconnect (const char *signal=nullptr, const QObject *receiver=nullptr, const char *member=nullptr) const
 
bool disconnect (const QObject *receiver, const char *member=nullptr) const
 
void dumpObjectTree () const
 
void dumpObjectInfo () const
 
bool setProperty (const char *name, const QVariant &value)
 
QVariant property (const char *name) const
 
QList< QByteArraydynamicPropertyNames () const
 
QBindingStoragebindingStorage ()
 
const QBindingStoragebindingStorage () const
 
QObjectparent () const
 
bool inherits (const char *classname) const
 
- Public Member Functions inherited from QPaintDevice
virtual ~QPaintDevice ()
 
bool paintingActive () const
 
int width () const
 
int height () const
 
int widthMM () const
 
int heightMM () const
 
int logicalDpiX () const
 
int logicalDpiY () const
 
int physicalDpiX () const
 
int physicalDpiY () const
 
qreal devicePixelRatio () const
 
qreal devicePixelRatioF () const
 
int colorCount () const
 
int depth () const
 

Protected Member Functions

void keyPressEvent (QKeyEvent *event) override
 
void focusInEvent (QFocusEvent *event) override
 
bool focusNextPrevChild (bool next) override
 
QValidator::State validate (QString &input, int &pos) const override
 
void fixup (QString &input) const override
 
virtual QDateTime dateTimeFromText (const QString &text) const
 
virtual QString textFromDateTime (const QDateTime &dt) const
 
StepEnabled stepEnabled () const override
 
void mousePressEvent (QMouseEvent *event) override
 
void paintEvent (QPaintEvent *event) override
 
void initStyleOption (QStyleOptionSpinBox *option) const override
 
 QDateTimeEdit (const QVariant &val, QMetaType::Type parserType, QWidget *parent=nullptr)
 
- Protected Member Functions inherited from QAbstractSpinBox
void resizeEvent (QResizeEvent *event) override
 
void keyReleaseEvent (QKeyEvent *event) override
 
void focusOutEvent (QFocusEvent *event) override
 
void changeEvent (QEvent *event) override
 
void closeEvent (QCloseEvent *event) override
 
void hideEvent (QHideEvent *event) override
 
void mouseReleaseEvent (QMouseEvent *event) override
 
void mouseMoveEvent (QMouseEvent *event) override
 
void timerEvent (QTimerEvent *event) override
 
void showEvent (QShowEvent *event) override
 
QLineEditlineEdit () const
 
void setLineEdit (QLineEdit *edit)
 
 QAbstractSpinBox (QAbstractSpinBoxPrivate &dd, QWidget *parent=nullptr)
 
- Protected Member Functions inherited from QWidget
virtual void mouseDoubleClickEvent (QMouseEvent *event)
 
virtual void enterEvent (QEnterEvent *event)
 
virtual void leaveEvent (QEvent *event)
 
virtual void moveEvent (QMoveEvent *event)
 
virtual void contextMenuEvent (QContextMenuEvent *event)
 
virtual void actionEvent (QActionEvent *event)
 
virtual bool nativeEvent (const QByteArray &eventType, void *message, qintptr *result)
 
int metric (PaintDeviceMetric) const override
 
void initPainter (QPainter *painter) const override
 
QPaintDeviceredirected (QPoint *offset) const override
 
QPaintersharedPainter () const override
 
virtual void inputMethodEvent (QInputMethodEvent *)
 
void create (WId=0, bool initializeWindow=true, bool destroyOldWindow=true)
 
void destroy (bool destroyWindow=true, bool destroySubWindows=true)
 
bool focusNextChild ()
 
bool focusPreviousChild ()
 
 QWidget (QWidgetPrivate &d, QWidget *parent, Qt::WindowFlags f)
 
- Protected Member Functions inherited from QObject
QObjectsender () const
 
int senderSignalIndex () const
 
int receivers (const char *signal) const
 
bool isSignalConnected (const QMetaMethod &signal) const
 
virtual void childEvent (QChildEvent *event)
 
virtual void customEvent (QEvent *event)
 
virtual void connectNotify (const QMetaMethod &signal)
 
virtual void disconnectNotify (const QMetaMethod &signal)
 
 QObject (QObjectPrivate &dd, QObject *parent=nullptr)
 
- Protected Member Functions inherited from QPaintDevice
 QPaintDevice () noexcept
 

Properties

QDateTime dateTime
 The QDateTime that is set in the QDateTimeEdit. More...
 
QDate date
 The QDate that is set in the widget. More...
 
QTime time
 The QTime that is set in the widget. More...
 
QDateTime maximumDateTime
 The maximum datetime of the date time edit. More...
 
QDateTime minimumDateTime
 The minimum datetime of the date time edit. More...
 
QDate maximumDate
 The maximum date of the date time edit. More...
 
QDate minimumDate
 The minimum date of the date time edit. More...
 
QTime maximumTime
 The maximum time of the date time edit. More...
 
QTime minimumTime
 The minimum time of the date time edit. More...
 
Section currentSection
 The current section of the spinbox. More...
 
Sections displayedSections
 The currently displayed fields of the date time edit. More...
 
QString displayFormat
 The format used to display the time/date of the date time edit. More...
 
bool calendarPopup
 The current calendar pop-up show mode. More...
 
int currentSectionIndex
 The current section index of the spinbox. More...
 
int sectionCount
 The number of sections displayed. If the format is 'yyyy/yy/yyyy', sectionCount returns 3. More...
 
Qt::TimeSpec timeSpec
 The current timespec used by the date time edit. More...
 
- Properties inherited from QAbstractSpinBox
bool wrapping
 whether the spin box is circular. More...
 
bool frame
 whether the spin box draws itself with a frame More...
 
Qt::Alignment alignment
 the alignment of the spin box More...
 
bool readOnly
 whether the spin box is read only. More...
 
ButtonSymbols buttonSymbols
 the current button symbol mode More...
 
QString specialValueText
 the special-value text More...
 
QString text
 the spin box's text, including any prefix and suffix More...
 
bool accelerated
 whether the spin box will accelerate the frequency of the steps when pressing the step Up/Down buttons. More...
 
CorrectionMode correctionMode
 the mode to correct an \l{QValidator::}{Intermediate} value if editing finishes More...
 
bool acceptableInput
 whether the input satisfies the current validation More...
 
bool keyboardTracking
 whether keyboard tracking is enabled for the spinbox. More...
 
bool showGroupSeparator
 whether a thousands separator is enabled. By default this property is false. More...
 
- Properties inherited from QWidget
bool modal
 whether the widget is a modal widget More...
 
Qt::WindowModality windowModality
 which windows are blocked by the modal widget More...
 
bool enabled
 whether the widget is enabled More...
 
QRect geometry
 the geometry of the widget relative to its parent and excluding the window frame More...
 
QRect frameGeometry
 geometry of the widget relative to its parent including any window frame More...
 
QRect normalGeometry
 the geometry of the widget as it will appear when shown as a normal (not maximized or full screen) top-level widget More...
 
int x
 the x coordinate of the widget relative to its parent including any window frame More...
 
int y
 the y coordinate of the widget relative to its parent and including any window frame More...
 
QPoint pos
 the position of the widget within its parent widget More...
 
QSize frameSize
 the size of the widget including any window frame More...
 
QSize size
 the size of the widget excluding any window frame More...
 
int width
 the width of the widget excluding any window frame More...
 
int height
 the height of the widget excluding any window frame More...
 
QRect rect
 the internal geometry of the widget excluding any window frame More...
 
QRect childrenRect
 the bounding rectangle of the widget's children More...
 
QRegion childrenRegion
 the combined region occupied by the widget's children More...
 
QSizePolicy sizePolicy
 the default layout behavior of the widget More...
 
QSize minimumSize
 the widget's minimum size More...
 
QSize maximumSize
 the widget's maximum size in pixels More...
 
int minimumWidth
 the widget's minimum width in pixels More...
 
int minimumHeight
 the widget's minimum height in pixels More...
 
int maximumWidth
 the widget's maximum width in pixels More...
 
int maximumHeight
 the widget's maximum height in pixels More...
 
QSize sizeIncrement
 the size increment of the widget More...
 
QSize baseSize
 the base size of the widget More...
 
QPalette palette
 the widget's palette More...
 
QFont font
 the font currently set for the widget More...
 
QCursor cursor
 the cursor shape for this widget More...
 
bool mouseTracking
 whether mouse tracking is enabled for the widget More...
 
bool tabletTracking
 whether tablet tracking is enabled for the widget More...
 
bool isActiveWindow
 whether this widget's window is the active window More...
 
Qt::FocusPolicy focusPolicy
 the way the widget accepts keyboard focus More...
 
bool focus
 whether this widget (or its focus proxy) has the keyboard input focus More...
 
Qt::ContextMenuPolicy contextMenuPolicy
 how the widget shows a context menu More...
 
bool updatesEnabled
 whether updates are enabled More...
 
bool visible
 whether the widget is visible More...
 
bool minimized
 whether this widget is minimized (iconified) More...
 
bool maximized
 whether this widget is maximized More...
 
bool fullScreen
 whether the widget is shown in full screen mode More...
 
QSize sizeHint
 the recommended size for the widget More...
 
QSize minimumSizeHint
 the recommended minimum size for the widget More...
 
bool acceptDrops
 whether drop events are enabled for this widget More...
 
QString windowTitle
 the window title (caption) More...
 
QIcon windowIcon
 the widget's icon More...
 
QString windowIconText
 the text to be displayed on the icon of a minimized window More...
 
double windowOpacity
 The level of opacity for the window. More...
 
bool windowModified
 whether the document shown in the window has unsaved changes More...
 
QString accessibleName
 the widget's name as seen by assistive technologies More...
 
QString accessibleDescription
 the widget's description as seen by assistive technologies More...
 
Qt::LayoutDirection layoutDirection
 the layout direction for this widget. More...
 
bool autoFillBackground
 whether the widget background is filled automatically More...
 
QString styleSheet
 the widget's style sheet More...
 
QLocale locale
 the widget's locale More...
 
QString windowFilePath
 the file path associated with a widget More...
 
Qt::InputMethodHints inputMethodHints
 What input method specific hints the widget has. More...
 
- Properties inherited from QObject
QString objectName
 the name of this object More...
 

Additional Inherited Members

- Static Public Member Functions inherited from QWidget
static void setTabOrder (QWidget *, QWidget *)
 
static QWidgetmouseGrabber ()
 
static QWidgetkeyboardGrabber ()
 
static QWidgetfind (WId)
 
static QWidgetcreateWindowContainer (QWindow *window, QWidget *parent=nullptr, Qt::WindowFlags flags=Qt::WindowFlags())
 
- Static Public Member Functions inherited from QObject
static QMetaObject::Connection connect (const QObject *sender, const char *signal, const QObject *receiver, const char *member, Qt::ConnectionType=Qt::AutoConnection)
 
static QMetaObject::Connection connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type=Qt::AutoConnection)
 
template<typename Func1 , typename Func2 >
static QMetaObject::Connection connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const typename QtPrivate::FunctionPointer< Func2 >::Object *receiver, Func2 slot, Qt::ConnectionType type=Qt::AutoConnection)
 
static QMetaObject::Connection ::type connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, Func2 slot)
 
static QMetaObject::Connection ::type connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const QObject *context, Func2 slot, Qt::ConnectionType type=Qt::AutoConnection)
 
template<typename Func1 , typename Func2 >
static std::enable_if< QtPrivate::FunctionPointer< Func2 >::ArgumentCount==-1 &&!std::is_convertible_v< Func2, const char * >, QMetaObject::Connection >::type connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, Func2 slot)
 
template<typename Func1 , typename Func2 >
static std::enable_if< QtPrivate::FunctionPointer< Func2 >::ArgumentCount==-1 &&!std::is_convertible_v< Func2, const char * >, QMetaObject::Connection >::type connect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const QObject *context, Func2 slot, Qt::ConnectionType type=Qt::AutoConnection)
 
static bool disconnect (const QObject *sender, const char *signal, const QObject *receiver, const char *member)
 
static bool disconnect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &member)
 
static bool disconnect (const QMetaObject::Connection &)
 
template<typename Func1 , typename Func2 >
static bool disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const typename QtPrivate::FunctionPointer< Func2 >::Object *receiver, Func2 slot)
 
template<typename Func1 >
static bool disconnect (const typename QtPrivate::FunctionPointer< Func1 >::Object *sender, Func1 signal, const QObject *receiver, void **zero)
 
- Static Public Member Functions inherited from QPaintDevice
static qreal devicePixelRatioFScale ()
 
- Protected Slots inherited from QWidget
void updateMicroFocus (Qt::InputMethodQuery query=Qt::ImQueryAll)
 
- Protected Attributes inherited from QObject
QScopedPointer< QObjectDatad_ptr
 
- Protected Attributes inherited from QPaintDevice
ushort painters
 

Detailed Description

The QDateTimeEdit class provides a widget for editing dates and times.

\inmodule QtWidgets

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().

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 range of valid values for a QDateTimeEdit is controlled by the properties \l minimumDateTime, \l maximumDateTime, and their respective date and time components. By default, any date-time from the start of 100 CE to the end of 9999 CE is valid.

Definition at line 57 of file qdatetimeedit.h.

Member Enumeration Documentation

◆ Section

\value NoSection \value AmPmSection \value MSecSection \value SecondSection \value MinuteSection \value HourSection \value DaySection \value MonthSection \value YearSection \omitvalue DateSections_Mask \omitvalue TimeSections_Mask

Enumerator
NoSection 
AmPmSection 
MSecSection 
SecondSection 
MinuteSection 
HourSection 
DaySection 
MonthSection 
YearSection 
TimeSections_Mask 
DateSections_Mask 

Definition at line 80 of file qdatetimeedit.h.

Constructor & Destructor Documentation

◆ QDateTimeEdit() [1/5]

QDateTimeEdit::QDateTimeEdit ( QWidget parent = nullptr)
explicit

Constructs an empty date time editor with a parent.

Definition at line 175 of file qdatetimeedit.cpp.

◆ QDateTimeEdit() [2/5]

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

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

Definition at line 187 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ QDateTimeEdit() [3/5]

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

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

Definition at line 201 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ QDateTimeEdit() [4/5]

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

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

Definition at line 215 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ ~QDateTimeEdit()

QDateTimeEdit::~QDateTimeEdit ( )

Destructor.

Definition at line 238 of file qdatetimeedit.cpp.

◆ QDateTimeEdit() [5/5]

QDateTimeEdit::QDateTimeEdit ( const QVariant val,
QMetaType::Type  parserType,
QWidget parent = nullptr 
)
protected

Definition at line 225 of file qdatetimeedit.cpp.

Member Function Documentation

◆ calendar()

QCalendar QDateTimeEdit::calendar ( ) const

Definition at line 347 of file qdatetimeedit.cpp.

Here is the caller graph for this function:

◆ calendarPopup()

bool QDateTimeEdit::calendarPopup ( ) const

Definition at line 1011 of file qdatetimeedit.cpp.

◆ calendarWidget()

QCalendarWidget * QDateTimeEdit::calendarWidget ( ) const

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

Since
4.4

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

Definition at line 840 of file qdatetimeedit.cpp.

Here is the caller graph for this function:

◆ clear()

void QDateTimeEdit::clear ( )
overridevirtual

\reimp

Reimplemented from QAbstractSpinBox.

Definition at line 1132 of file qdatetimeedit.cpp.

◆ clearMaximumDate()

void QDateTimeEdit::clearMaximumDate ( )

Definition at line 556 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ clearMaximumDateTime()

void QDateTimeEdit::clearMaximumDateTime ( )

Definition at line 432 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ clearMaximumTime()

void QDateTimeEdit::clearMaximumTime ( )

Definition at line 635 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ clearMinimumDate()

void QDateTimeEdit::clearMinimumDate ( )

Definition at line 516 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ clearMinimumDateTime()

void QDateTimeEdit::clearMinimumDateTime ( )

Definition at line 390 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ clearMinimumTime()

void QDateTimeEdit::clearMinimumTime ( )

Definition at line 596 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ currentSection()

QDateTimeEdit::Section QDateTimeEdit::currentSection ( ) const

Definition at line 736 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ currentSectionIndex()

int QDateTimeEdit::currentSectionIndex ( ) const

Definition at line 816 of file qdatetimeedit.cpp.

◆ date()

QDate QDateTimeEdit::date ( ) const

Returns the date of the date time edit.

Definition at line 294 of file qdatetimeedit.cpp.

◆ dateChanged

void QDateTimeEdit::dateChanged ( QDate  date)
signal

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

See also
{Keyboard Tracking}
Here is the caller graph for this function:

◆ dateTime()

QDateTime QDateTimeEdit::dateTime ( ) const

Definition at line 261 of file qdatetimeedit.cpp.

◆ dateTimeChanged

void QDateTimeEdit::dateTimeChanged ( const QDateTime datetime)
signal

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

See also
{Keyboard Tracking}

◆ dateTimeFromText()

QDateTime QDateTimeEdit::dateTimeFromText ( const QString text) const
protectedvirtual

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(), validate()

Definition at line 1451 of file qdatetimeedit.cpp.

◆ displayedSections()

QDateTimeEdit::Sections QDateTimeEdit::displayedSections ( ) const

Definition at line 724 of file qdatetimeedit.cpp.

◆ displayFormat()

QString QDateTimeEdit::displayFormat ( ) const

Definition at line 952 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ event()

bool QDateTimeEdit::event ( QEvent event)
overridevirtual

\reimp

Reimplemented from QAbstractSpinBox.

Definition at line 1102 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ fixup()

void QDateTimeEdit::fixup ( QString input) const
overrideprotectedvirtual

\reimp

Reimplemented from QAbstractSpinBox.

Definition at line 1477 of file qdatetimeedit.cpp.

◆ focusInEvent()

void QDateTimeEdit::focusInEvent ( QFocusEvent event)
overrideprotectedvirtual

\reimp

\reimp

Reimplemented from QAbstractSpinBox.

Definition at line 1296 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ focusNextPrevChild()

bool QDateTimeEdit::focusNextPrevChild ( bool  next)
overrideprotectedvirtual

\reimp

Reimplemented from QWidget.

Definition at line 1349 of file qdatetimeedit.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ initStyleOption()

void QDateTimeEdit::initStyleOption ( QStyleOptionSpinBox *  option) const
overrideprotectedvirtual

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

Reimplemented from QAbstractSpinBox.

Definition at line 2494 of file qdatetimeedit.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ keyPressEvent()

void QDateTimeEdit::keyPressEvent ( QKeyEvent event)
overrideprotectedvirtual

\reimp

Reimplemented from QAbstractSpinBox.

Definition at line 1141 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ maximumDate()

QDate QDateTimeEdit::maximumDate ( ) const

Definition at line 543 of file qdatetimeedit.cpp.

◆ maximumDateTime()

QDateTime QDateTimeEdit::maximumDateTime ( ) const

Definition at line 426 of file qdatetimeedit.cpp.

◆ maximumTime()

QTime QDateTimeEdit::maximumTime ( ) const

Definition at line 620 of file qdatetimeedit.cpp.

◆ minimumDate()

QDate QDateTimeEdit::minimumDate ( ) const

Definition at line 502 of file qdatetimeedit.cpp.

◆ minimumDateTime()

QDateTime QDateTimeEdit::minimumDateTime ( ) const

Definition at line 384 of file qdatetimeedit.cpp.

◆ minimumTime()

QTime QDateTimeEdit::minimumTime ( ) const

Definition at line 581 of file qdatetimeedit.cpp.

◆ mousePressEvent()

void QDateTimeEdit::mousePressEvent ( QMouseEvent event)
overrideprotectedvirtual

\reimp

Reimplemented from QAbstractSpinBox.

Definition at line 1567 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ paintEvent()

void QDateTimeEdit::paintEvent ( QPaintEvent event)
overrideprotectedvirtual

\reimp

Reimplemented from QAbstractSpinBox.

Definition at line 2421 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ sectionAt()

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

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,

Definition at line 778 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ sectionCount()

int QDateTimeEdit::sectionCount ( ) const

Definition at line 795 of file qdatetimeedit.cpp.

◆ sectionText()

QString QDateTimeEdit::sectionText ( Section  section) const

Returns the text from the given section.

See also
currentSection()

Definition at line 915 of file qdatetimeedit.cpp.

◆ setCalendar()

void QDateTimeEdit::setCalendar ( QCalendar  calendar)

Definition at line 353 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ setCalendarPopup()

void QDateTimeEdit::setCalendarPopup ( bool  enable)

Definition at line 1017 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ setCalendarWidget()

void QDateTimeEdit::setCalendarWidget ( QCalendarWidget calendarWidget)
Since
4.4

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.
See also
calendarPopup

Definition at line 860 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ setCurrentSection()

void QDateTimeEdit::setCurrentSection ( Section  section)

Definition at line 746 of file qdatetimeedit.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ setCurrentSectionIndex()

void QDateTimeEdit::setCurrentSectionIndex ( int  index)

Definition at line 822 of file qdatetimeedit.cpp.

◆ setDate

void QDateTimeEdit::setDate ( QDate  date)
slot

Definition at line 300 of file qdatetimeedit.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ setDateRange()

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

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

This convenience function sets the \l minimumDate and \l maximumDate properties.

is analogous to:

If either min or max is invalid, this function does nothing. This function preserves the \l 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 \l maximumTime property was less then the \l minimumTime property, the \l maximumTime property is set to the \l minimumTime property. Otherwise, this preserves the \l 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(), {Keyboard Tracking}

Definition at line 666 of file qdatetimeedit.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ setDateTime

void QDateTimeEdit::setDateTime ( const QDateTime dateTime)
slot

Definition at line 267 of file qdatetimeedit.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ setDateTimeRange()

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

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

Since
4.4

This convenience function sets the \l minimumDateTime and \l maximumDateTime properties.

is analogous to:

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(), {Keyboard Tracking}

Definition at line 471 of file qdatetimeedit.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ setDisplayFormat()

void QDateTimeEdit::setDisplayFormat ( const QString format)

Definition at line 958 of file qdatetimeedit.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ setMaximumDate()

void QDateTimeEdit::setMaximumDate ( QDate  max)

Definition at line 549 of file qdatetimeedit.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ setMaximumDateTime()

void QDateTimeEdit::setMaximumDateTime ( const QDateTime dt)

Definition at line 437 of file qdatetimeedit.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ setMaximumTime()

void QDateTimeEdit::setMaximumTime ( QTime  max)

Definition at line 626 of file qdatetimeedit.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ setMinimumDate()

void QDateTimeEdit::setMinimumDate ( QDate  min)

Definition at line 508 of file qdatetimeedit.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ setMinimumDateTime()

void QDateTimeEdit::setMinimumDateTime ( const QDateTime dt)

Definition at line 395 of file qdatetimeedit.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ setMinimumTime()

void QDateTimeEdit::setMinimumTime ( QTime  min)

Definition at line 587 of file qdatetimeedit.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ setSelectedSection()

void QDateTimeEdit::setSelectedSection ( Section  section)
Since
4.2

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

Definition at line 893 of file qdatetimeedit.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ setTime

void QDateTimeEdit::setTime ( QTime  time)
slot

Definition at line 337 of file qdatetimeedit.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ setTimeRange()

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

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

This convenience function sets the \l minimumTime and \l maximumTime properties.

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

is analogous to:

If either min or max is invalid, this function does nothing. This function preserves the \l minimumDate and \l 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(), {Keyboard Tracking}

Definition at line 705 of file qdatetimeedit.cpp.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ setTimeSpec()

void QDateTimeEdit::setTimeSpec ( Qt::TimeSpec  spec)

Definition at line 1044 of file qdatetimeedit.cpp.

◆ sizeHint()

QSize QDateTimeEdit::sizeHint ( ) const
overridevirtual

\reimp

Reimplemented from QAbstractSpinBox.

Definition at line 1057 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ stepBy()

void QDateTimeEdit::stepBy ( int  steps)
overridevirtual

\reimp

Reimplemented from QAbstractSpinBox.

Definition at line 1371 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ stepEnabled()

QDateTimeEdit::StepEnabled QDateTimeEdit::stepEnabled ( ) const
overrideprotectedvirtual

\reimp

Reimplemented from QAbstractSpinBox.

Definition at line 1500 of file qdatetimeedit.cpp.

◆ textFromDateTime()

QString QDateTimeEdit::textFromDateTime ( const QDateTime dateTime) const
protectedvirtual

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(), validate()

Definition at line 1436 of file qdatetimeedit.cpp.

Here is the call graph for this function:

◆ time()

QTime QDateTimeEdit::time ( ) const

Returns the time of the date time edit.

Definition at line 331 of file qdatetimeedit.cpp.

◆ timeChanged

void QDateTimeEdit::timeChanged ( QTime  time)
signal

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

See also
{Keyboard Tracking}
Here is the caller graph for this function:

◆ timeSpec()

Qt::TimeSpec QDateTimeEdit::timeSpec ( ) const

Definition at line 1038 of file qdatetimeedit.cpp.

◆ validate()

QValidator::State QDateTimeEdit::validate ( QString text,
int &  pos 
) const
overrideprotectedvirtual

\reimp

Reimplemented from QAbstractSpinBox.

Definition at line 1464 of file qdatetimeedit.cpp.

Here is the caller graph for this function:

Property Documentation

◆ calendarPopup

QDateTimeEdit::calendarPopup
readwrite

The current calendar pop-up show mode.

Since
4.2

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

Definition at line 236 of file qdatetimeedit.h.

◆ currentSection

QDateTimeEdit::currentSection
readwrite

The current section of the spinbox.

Definition at line 236 of file qdatetimeedit.h.

◆ currentSectionIndex

QDateTimeEdit::currentSectionIndex
readwrite

The current section index of the spinbox.

Since
4.3

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, and so on.

See also
setCurrentSection(), currentSection()

Definition at line 236 of file qdatetimeedit.h.

◆ date

QDateTimeEdit::date
readwrite

The QDate that is set in the widget.

By default, this property contains a date that refers to January 1, 2000.

See also
time, dateTime

Definition at line 236 of file qdatetimeedit.h.

◆ dateTime

QDateTimeEdit::dateTime
readwrite

The QDateTime that is set in the QDateTimeEdit.

When setting this property, the new QDateTime is converted to the timespec of the QDateTimeEdit, which thus remains unchanged.

By default, this property is set to the start of 2000 CE. It can only be set to a valid QDateTime value. If any operation causes this property to have an invalid date-time as value, it is reset to the value of the \l minimumDateTime property.

If the QDateTimeEdit has no date fields, setting this property sets the widget's date-range to start and end on the date of the new value of this property.

See also
date, time, minimumDateTime, maximumDateTime

Definition at line 236 of file qdatetimeedit.h.

◆ displayedSections

QDateTimeEdit::displayedSections
read

The currently displayed fields of the date time edit.

Returns a bit set of the displayed sections for this format.

See also
setDisplayFormat(), displayFormat()

Definition at line 236 of file qdatetimeedit.h.

◆ displayFormat

QDateTimeEdit::displayFormat
readwrite

The format used to display the time/date of the date time edit.

This format is described in QDateTime::toString() and QDateTime::fromString()

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

\table \header

  • Format
  • Result \row
  • dd.MM.yyyy
  • 02.07.1969 \row
  • MMM d yy
  • Jul 2 69 \row
  • MMMM d yy
  • July 2 69 \endtable

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 21st (2000-2099).

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

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

Definition at line 236 of file qdatetimeedit.h.

◆ maximumDate

QDateTimeEdit::maximumDate
readwrite

The maximum date of the date time edit.

Changing this property updates the date of the \l maximumDateTime property while preserving the \l maximumTime property. When setting this property, the \l minimumDate is adjusted, if necessary, to ensure that the range remains valid. When this happens, the \l minimumTime property is also adjusted if it is greater than the \l maximumTime property. Otherwise, changes to this property preserve the \l minimumDateTime property.

This property can only be set to a valid QDate object describing a date on which the current \l maximumTime property makes a valid QDateTime object. The latest date that setMaximumDate() accepts is the end of 9999 CE. This is the default for this property. This default can be restored with clearMaximumDateTime().

See also
minimumDate, maximumTime, maximumDateTime, setDateRange(), QDate::isValid(), {Keyboard Tracking}

Definition at line 236 of file qdatetimeedit.h.

◆ maximumDateTime

QDateTimeEdit::maximumDateTime
readwrite

The maximum datetime of the date time edit.

Since
4.4

Changing this property implicitly updates the \l maximumDate and \l maximumTime properties to the date and time parts of this property, respectively. When setting this property, the \l minimumDateTime is adjusted, if necessary, to ensure that the range remains valid. Otherwise, changing this property preserves the \l minimumDateTime property.

This property can only be set to a valid QDateTime value. The latest date-time that setMaximumDateTime() accepts is the end of 9999 CE. This is the default for this property. This default can be restored with clearMaximumDateTime().

See also
minimumDateTime, maximumTime, maximumDate(), setDateTimeRange(), QDateTime::isValid(), {Keyboard Tracking}

Definition at line 236 of file qdatetimeedit.h.

◆ maximumTime

QDateTimeEdit::maximumTime
readwrite

The maximum time of the date time edit.

Changing this property updates the time of the \l maximumDateTime property while preserving the \l minimumDate and \l maximumDate properties. If those date properties coincide, when setting this property, the \l minimumTime property is adjusted, if necessary, to ensure that the range remains valid. Otherwise, changing this property preserves the \l minimumDateTime property.

This property can be set to any valid QTime value. By default, this property contains a time of 23:59:59 and 999 milliseconds. This default can be restored with clearMaximumTime().

See also
minimumTime, maximumDate, maximumDateTime, setTimeRange(), QTime::isValid(), {Keyboard Tracking}

Definition at line 236 of file qdatetimeedit.h.

◆ minimumDate

QDateTimeEdit::minimumDate
readwrite

The minimum date of the date time edit.

Changing this property updates the date of the \l minimumDateTime property while preserving the \l minimumTime property. When setting this property, the \l maximumDate is adjusted, if necessary, to ensure that the range remains valid. When this happens, the \l maximumTime property is also adjusted if it is less than the \l minimumTime property. Otherwise, changes to this property preserve the \l maximumDateTime property.

This property can only be set to a valid QDate object describing a date on which the current \l minimumTime property makes a valid QDateTime object. The earliest date that setMinimumDate() accepts is the start of 100 CE. The default for this property is September 14, 1752 CE. This default can be restored with clearMinimumDateTime().

See also
maximumDate, minimumTime, minimumDateTime, setDateRange(), QDate::isValid(), {Keyboard Tracking}

Definition at line 236 of file qdatetimeedit.h.

◆ minimumDateTime

QDateTimeEdit::minimumDateTime
readwrite

The minimum datetime of the date time edit.

Since
4.4

Changing this property implicitly updates the \l minimumDate and \l minimumTime properties to the date and time parts of this property, respectively. When setting this property, the \l maximumDateTime is adjusted, if necessary, to ensure that the range remains valid. Otherwise, changing this property preserves the \l maximumDateTime property.

This property can only be set to a valid QDateTime value. The earliest date-time that setMinimumDateTime() accepts is the start of 100 CE. The property's default is the start of September 14, 1752 CE. This default can be restored with clearMinimumDateTime().

See also
maximumDateTime, minimumTime, minimumDate, setDateTimeRange(), QDateTime::isValid(), {Keyboard Tracking}

Definition at line 236 of file qdatetimeedit.h.

◆ minimumTime

QDateTimeEdit::minimumTime
readwrite

The minimum time of the date time edit.

Changing this property updates the time of the \l minimumDateTime property while preserving the \l minimumDate and \l maximumDate properties. If those date properties coincide, when setting this property, the \l maximumTime property is adjusted, if necessary, to ensure that the range remains valid. Otherwise, changing this property preserves the \l maximumDateTime property.

This property can be set to any valid QTime value. By default, this property contains a time of 00:00:00 and 0 milliseconds. This default can be restored with clearMinimumTime().

See also
maximumTime, minimumDate, minimumDateTime, setTimeRange(), QTime::isValid(), {Keyboard Tracking}

Definition at line 236 of file qdatetimeedit.h.

◆ sectionCount

QDateTimeEdit::sectionCount
read

The number of sections displayed. If the format is 'yyyy/yy/yyyy', sectionCount returns 3.

Since
4.3

Definition at line 236 of file qdatetimeedit.h.

◆ time

QDateTimeEdit::time
readwrite

The QTime that is set in the widget.

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

See also
date, dateTime

Definition at line 236 of file qdatetimeedit.h.

◆ timeSpec

QDateTimeEdit::timeSpec
readwrite

The current timespec used by the date time edit.

Since
4.4

Definition at line 236 of file qdatetimeedit.h.


The documentation for this class was generated from the following files: