QDateTimeEdit Class Reference

QDateTimeEdit Class Reference

[QtGui module]

该QDateTimeEdit类提供了一个部件的编辑日期和时间。More…

继承QAbstractSpinBox。

通过继承QDateEdit和QTimeEdit。

Types

enum Section { NoSection, AmPmSection, MSecSection, SecondSection, ..., DateSections_Mask }
class **[Sections]($docs-index.htm)**

Methods

__init__ (self, QWidget parent = None)
__init__ (self, QDateTime datetime, QWidget parent = None)
__init__ (self, QDate date, QWidget parent = None)
__init__ (self, QTime time, QWidget parent = None)
bool calendarPopup (self)
QCalendarWidget calendarWidget (self)
clear (self)
clearMaximumDate (self)
clearMaximumDateTime (self)
clearMaximumTime (self)
clearMinimumDate (self)
clearMinimumDateTime (self)
clearMinimumTime (self)
Section currentSection (self)
int currentSectionIndex (self)
QDate date (self)
QDateTime dateTime (self)
QDateTime dateTimeFromText (self, QString text)
Sections displayedSections (self)
QString displayFormat (self)
bool event (self, QEvent e)
QString input fixup (self, QString input)
fixup (self, QString input)
focusInEvent (self, QFocusEvent e)
bool focusNextPrevChild (self, bool next)
initStyleOption (self, QStyleOptionSpinBox option)
keyPressEvent (self, QKeyEvent e)
QDate maximumDate (self)
QDateTime maximumDateTime (self)
QTime maximumTime (self)
QDate minimumDate (self)
QDateTime minimumDateTime (self)
QTime minimumTime (self)
mousePressEvent (self, QMouseEvent event)
paintEvent (self, QPaintEvent event)
Section sectionAt (self, int index)
int sectionCount (self)
QString sectionText (self, Section s)
setCalendarPopup (self, bool enable)
setCalendarWidget (self, QCalendarWidget calendarWidget)
setCurrentSection (self, Section section)
setCurrentSectionIndex (self, int index)
setDate (self, QDate date)
setDateRange (self, QDate min, QDate max)
setDateTime (self, QDateTime dateTime)
setDateTimeRange (self, QDateTime min, QDateTime max)
setDisplayFormat (self, QString format)
setMaximumDate (self, QDate max)
setMaximumDateTime (self, QDateTime dt)
setMaximumTime (self, QTime max)
setMinimumDate (self, QDate min)
setMinimumDateTime (self, QDateTime dt)
setMinimumTime (self, QTime min)
setSelectedSection (self, Section section)
setTime (self, QTime time)
setTimeRange (self, QTime min, QTime max)
setTimeSpec (self, Qt.TimeSpec spec)
QSize sizeHint (self)
stepBy (self, int steps)
QAbstractSpinBox.StepEnabled stepEnabled (self)
QString textFromDateTime (self, QDateTime dt)
QTime time (self)
Qt.TimeSpec timeSpec (self)
(QValidator.State, QString input, int pos) validate (self, QString input, int pos)
(QValidator.State, int pos) validate (self, QString input, int pos)
wheelEvent (self, QWheelEvent e)

Qt Signals

void dateChanged (const QDate&)
void dateTimeChanged (const QDateTime&)
void timeChanged (const QTime&)

Detailed Description

该QDateTimeEdit类提供了一个部件的编辑日期和时间。

QDateTimeEdit允许用户通过使用键盘或箭头键来增加和减少的日期和时间值进行编辑的日期。箭头键可以用来从部分移动到QDateTimeEdit框内部分。日期和时间出现在按照设定的格式，见setDisplayFormat（）。

 QDateTimeEdit *dateEdit = new QDateTimeEdit([QDate]($docs-qdate.html).currentDate());
 dateEdit->setMinimumDate([QDate]($docs-qdate.html).currentDate().addDays(-365));
 dateEdit->setMaximumDate([QDate]($docs-qdate.html).currentDate().addDays(365));
 dateEdit->setDisplayFormat("yyyy.MM.dd");

在这里，我们已经创建了今天的日期初始化的新QDateTimeEdit对象，并制约了有效日期范围到今天正负365天。我们已经设置为月，日，年。

对于QDateTimeEdit最小值为1752年9月14日，和1月2日4713BC的QDate。您可以通过调用改变这个setMinimumDate（）setMaximumDate（）setMinimumTime（）和setMaximumTime（）。

Using a Pop-up Calendar Widget

QDateTimeEdit可以被配置为允许QCalendarWidget将用于选择的日期。这是通过设置启用calendarPopup属性。此外，您可以通过调用提供自定义日历组件用作日历弹出setCalendarWidget（）函数。现有的日历控件可以检索与calendarWidget（）。

| Screenshot of a Windows XP style date time editing widget | A date time editing widget shown in the Windows XP widget style. | | Screenshot of a Macintosh style date time editing widget | A date time editing widget shown in the Macintosh widget style. | | Screenshot of a Plastique style date time editing widget | A date time editing widget shown in the Plastique widget style. |

Type Documentation

QDateTimeEdit.Section

Constant	Value
`QDateTimeEdit.NoSection`	`0x0000`
`QDateTimeEdit.AmPmSection`	`0x0001`
`QDateTimeEdit.MSecSection`	`0x0002`
`QDateTimeEdit.SecondSection`	`0x0004`
`QDateTimeEdit.MinuteSection`	`0x0008`
`QDateTimeEdit.HourSection`	`0x0010`
`QDateTimeEdit.DaySection`	`0x0100`
`QDateTimeEdit.MonthSection`	`0x0200`
`QDateTimeEdit.YearSection`	`0x0400`

该部分类型是一个typedef为QFlags\u003cSECTION\u003e 。它存储段值的或组合。

Method Documentation

QDateTimeEdit.__init__ (self, QWidget parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个空的日期时间编辑器parent。

QDateTimeEdit.__init__ (self, QDateTime datetime, QWidget parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个空的日期时间编辑器parent。该值被设置为datetime。

QDateTimeEdit.__init__ (self, QDate date, QWidget parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个空的日期时间编辑器parent。该值被设置为date。

QDateTimeEdit.__init__ (self, QTime time, QWidget parent = None)

该parent的说法，如果不是没有，原因self通过Qt的，而不是PyQt的拥有。

构造一个空的日期时间编辑器parent。该值被设置为time。

bool QDateTimeEdit.calendarPopup (self)

QCalendarWidget QDateTimeEdit.calendarWidget (self)

返回日历窗口小部件的编辑器，如果 calendarPopup被设置为True和（sections（）和DateSections_Mask！） = 0 。

这个函数创建并返回一个日历组件，如果没有设置。

此功能被引入Qt的4.4 。

See also setCalendarWidget（）。

QDateTimeEdit.clear (self)

从重新实现QAbstractSpinBox.clear（）。

QDateTimeEdit.clearMaximumDate (self)

QDateTimeEdit.clearMaximumDateTime (self)

QDateTimeEdit.clearMaximumTime (self)

QDateTimeEdit.clearMinimumDate (self)

QDateTimeEdit.clearMinimumDateTime (self)

QDateTimeEdit.clearMinimumTime (self)

Section QDateTimeEdit.currentSection (self)

[

int QDateTimeEdit.currentSectionIndex (self)

]($docs-qdatetimeedit.html#Section-enum)

QDate QDateTimeEdit.date (self)

QDateTime QDateTimeEdit.dateTime (self)

QDateTime QDateTimeEdit.dateTimeFromText (self, QString text)

[

返回一个适当的日期时间为给定的text。

这个虚拟函数是所使用的日期时间编辑时，它需要解释由用户输入的值的文本。

]($docs-qdatetime.html)

See also textFromDateTime（）和validate（）。

Sections QDateTimeEdit.displayedSections (self)

[

QString QDateTimeEdit.displayFormat (self)

bool QDateTimeEdit.event (self, QEvent e)

]($docs-index.htm)

从重新实现 QObject.event（）。

QString input QDateTimeEdit.fixup (self, QString input)

从重新实现QAbstractSpinBox.fixup（）。

QDateTimeEdit.fixup (self, QString input)

QDateTimeEdit.focusInEvent (self, QFocusEvent e)

从重新实现QWidget.focusInEvent（）。

bool QDateTimeEdit.focusNextPrevChild (self, bool next)

从重新实现QWidget.focusNextPrevChild（）。

QDateTimeEdit.initStyleOption (self, QStyleOptionSpinBox option)

初始化option与这QDataTimeEdit的值。当他们需要一个这种方法是有用的子类QStyleOptionSpinBox，但不希望在所有的信息填写自己。

See also QStyleOption.initFrom（）。

QDateTimeEdit.keyPressEvent (self, QKeyEvent e)

从重新实现QWidget.keyPressEvent（）。

QDate QDateTimeEdit.maximumDate (self)

QDateTime QDateTimeEdit.maximumDateTime (self)

QTime QDateTimeEdit.maximumTime (self)

QDate QDateTimeEdit.minimumDate (self)

QDateTime QDateTimeEdit.minimumDateTime (self)

QTime QDateTimeEdit.minimumTime (self)

[

QDateTimeEdit.mousePressEvent (self, QMouseEvent event)

]($docs-qtime.html)

从重新实现 QWidget.mousePressEvent（）。

QDateTimeEdit.paintEvent (self, QPaintEvent event)

从重新实现QWidget.paintEvent（）。

Section QDateTimeEdit.sectionAt (self, int index)

[

返回科index。

]($docs-qdatetimeedit.html#Section-enum)

如果格式是’YYYY / MM / DD ‘ ， sectionAt （ 0 ）返回 YearSection， sectionAt （ 1 ）返回MonthSection和sectionAt （2）返回YearSection，

此功能被引入Qt的4.3 。

int QDateTimeEdit.sectionCount (self)

QString QDateTimeEdit.sectionText (self, Section s)

从给定的返回文本section。

See also currentSection（）。

QDateTimeEdit.setCalendarPopup (self, bool enable)

QDateTimeEdit.setCalendarWidget (self, QCalendarWidget calendarWidget)

该calendarWidget说法有它的所有权转移给Qt的。

设置给定calendarWidget作为要用于日历弹出的窗口小部件。编辑器不会自动把日历窗口小部件的所有权。

Note: calendarPopup设置日历控件之前，必须设置为True。

此功能被引入Qt的4.4 。

See also calendarWidget（）和calendarPopup。

QDateTimeEdit.setCurrentSection (self, Section section)

QDateTimeEdit.setCurrentSectionIndex (self, int index)

QDateTimeEdit.setDate (self, QDate date)

这种方法也是一个Qt槽与C + +的签名void setDate(const QDate&)。

QDateTimeEdit.setDateRange (self, QDate min, QDate max)

方便的功能来设置最小和最大日期用一个函数调用。

 setDateRange(min, max);

类似于：

 setMinimumDate(min);
 setMaximumDate(max);

如果任min or max是无效的，这个函数不执行任何操作。

See also setMinimumDate（）maximumDate（）setMaximumDate（）clearMinimumDate（）setMinimumTime（）maximumTime（）setMaximumTime（）clearMinimumTime（）和QDate.isValid（）。

QDateTimeEdit.setDateTime (self, QDateTime dateTime)

这种方法也是一个Qt槽与C + +的签名void setDateTime(const QDateTime&)。

QDateTimeEdit.setDateTimeRange (self, QDateTime min, QDateTime max)

方便的功能来设置最小和最大日期与时间一个函数调用。

 setDateTimeRange(min, max);

类似于：

 setMinimumDateTime(min);
 setMaximumDateTime(max);

如果任min or max是无效的，这个函数不执行任何操作。

此功能被引入Qt的4.4 。

See also setMinimumDate（）maximumDate（）setMaximumDate（）clearMinimumDate（）setMinimumTime（）maximumTime（）setMaximumTime（）clearMinimumTime（）和QDateTime.isValid（）。

QDateTimeEdit.setDisplayFormat (self, QString format)

QDateTimeEdit.setMaximumDate (self, QDate max)

QDateTimeEdit.setMaximumDateTime (self, QDateTime dt)

QDateTimeEdit.setMaximumTime (self, QTime max)

QDateTimeEdit.setMinimumDate (self, QDate min)

QDateTimeEdit.setMinimumDateTime (self, QDateTime dt)

QDateTimeEdit.setMinimumTime (self, QTime min)

QDateTimeEdit.setSelectedSection (self, Section section)

Selects section。如果section在当前显示的部分不存在这个函数什么都不做。如果section is NoSection此功能将取消选择在编辑器中的所有文本。否则，此函数将移动光标和当前部分选定的部分。

这个函数中引入了Qt 4.2中。

See also currentSection（）。

QDateTimeEdit.setTime (self, QTime time)

这种方法也是一个Qt槽与C + +的签名void setTime(const QTime&)。

QDateTimeEdit.setTimeRange (self, QTime min, QTime max)

方便的功能来设置最小和最大时间有一个函数调用。

 setTimeRange(min, max);

类似于：

 setMinimumTime(min);
 setMaximumTime(max);

如果任min or max是无效的，这个函数不执行任何操作。

See also setMinimumDate（）maximumDate（）setMaximumDate（）clearMinimumDate（）setMinimumTime（）maximumTime（）setMaximumTime（）clearMinimumTime（）和QTime.isValid（）。

QDateTimeEdit.setTimeSpec (self, Qt.TimeSpec spec)

QSize QDateTimeEdit.sizeHint (self)

从重新实现 QWidget.sizeHint（）。

QDateTimeEdit.stepBy (self, int steps)

从重新实现QAbstractSpinBox.stepBy（）。

QAbstractSpinBox.StepEnabled QDateTimeEdit.stepEnabled (self)

从重新实现 QAbstractSpinBox.stepEnabled（）。

QString QDateTimeEdit.textFromDateTime (self, QDateTime dt)

这个虚函数所使用的日期时间编辑时，它需要显示dateTime。

如果你重新实现这一点，您可能还需要重新实现validate（）。

See also dateTimeFromText（）和validate（）。

QTime QDateTimeEdit.time (self)

Qt.TimeSpec QDateTimeEdit.timeSpec (self)

[

(QValidator.State, QString input, int pos) QDateTimeEdit.validate (self, QString input, int pos)

]($docs-qt.html#TimeSpec-enum)

从重新实现 QAbstractSpinBox.validate（）。

(QValidator.State, int pos) QDateTimeEdit.validate (self, QString input, int pos)

QDateTimeEdit.wheelEvent (self, QWheelEvent e)

从重新实现QWidget.wheelEvent（）。

Qt Signal Documentation

void dateChanged (const QDate&)

这是该信号的默认超载。

这个信号被发射时的时间被改变。新的日期是在传递date。

void dateTimeChanged (const QDateTime&)

这是该信号的默认超载。

这个信号被发射时的日期或时间而改变。新的日期和时间被传递datetime。

void timeChanged (const QTime&)

这是该信号的默认超载。

这个信号被发射时的时间被改变。新的时间被传递time。