QDateTimeEdit Class Reference · PyQt4 中文文檔

# QDateTimeEdit Class Reference ## [[QtGui](index.htm) module] 該QDateTimeEdit類提供了一個部件的編輯日期和時間。[More...](#details) 繼承[QAbstractSpinBox](qabstractspinbox.html)。通過繼承[QDateEdit](qdateedit.html)和[QTimeEdit](qtimeedit.html)。 ### Types * `enum Section { NoSection, AmPmSection, MSecSection, SecondSection, ..., DateSections_Mask }` * `class **[Sections](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.html#displayFormat-prop)（）。 ``` QDateTimeEdit *dateEdit = new QDateTimeEdit([QDate](qdate.html).currentDate()); dateEdit->setMinimumDate([QDate](qdate.html).currentDate().addDays(-365)); dateEdit->setMaximumDate([QDate](qdate.html).currentDate().addDays(365)); dateEdit->setDisplayFormat("yyyy.MM.dd"); ``` 在這里，我們已經創建了今天的日期初始化的新QDateTimeEdit對象，并制約了有效日期范圍到今天正負365天。我們已經設置為月，日，年。對于QDateTimeEdit最小值為1752年9月14日，和1月2日4713BC的[QDate](qdate.html)。您可以通過調用改變這個[setMinimumDate](qdatetimeedit.html#minimumDate-prop)（）[setMaximumDate](qdatetimeedit.html#maximumDate-prop)（）[setMinimumTime](qdatetimeedit.html#minimumTime-prop)（）和[setMaximumTime](qdatetimeedit.html#maximumTime-prop)（）。 ### Using a Pop-up Calendar Widget QDateTimeEdit可以被配置為允許[QCalendarWidget](qcalendarwidget.html)將用于選擇的日期。這是通過設置啟用[calendarPopup](qdatetimeedit.html#calendarPopup-prop)屬性。此外，您可以通過調用提供自定義日歷組件用作日歷彈出[setCalendarWidget](qdatetimeedit.html#setCalendarWidget)（）函數。現有的日歷控件可以檢索與[calendarWidget](qdatetimeedit.html#calendarWidget)（）。 | ![Screenshot of a Windows XP style date time editing widget](https://img.kancloud.cn/c4/74/c4740676e60a487dd477395d38792733_314x30.png) | A date time editing widget shown in the [Windows XP widget style](index.htm). | | ![Screenshot of a Macintosh style date time editing widget](https://img.kancloud.cn/b1/26/b12649fe117aaa61412621886d31a3cb_300x39.png) | A date time editing widget shown in the [Macintosh widget style](index.htm). | | ![Screenshot of a Plastique style date time editing widget](https://img.kancloud.cn/9d/12/9d12caef656860c776d7a58d1860c111_211x33.png) | A date time editing widget shown in the [Plastique widget style](index.htm). | * * * ## 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](index.htm)\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) ``` [](qcalendarwidget.html) [返回日歷窗口小部件的編輯器，如果](qcalendarwidget.html)[calendarPopup](qdatetimeedit.html#calendarPopup-prop)被設置為True和（[sections](index.htm#sections)（）和[DateSections_Mask](qdatetimeedit.html#Section-enum)！） = 0 。這個函數創建并返回一個日歷組件，如果沒有設置。此功能被引入Qt的4.4 。 **See also** [setCalendarWidget](qdatetimeedit.html#setCalendarWidget)（）。 ``` QDateTimeEdit.clear (self) ``` 從重新實現[QAbstractSpinBox.clear](qabstractspinbox.html#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) ``` ](qdatetimeedit.html#Section-enum) ``` QDate QDateTimeEdit.date (self) ``` [](qdate.html) ``` QDateTime QDateTimeEdit.dateTime (self) ``` [](qdatetime.html) ``` QDateTime QDateTimeEdit.dateTimeFromText (self, QString?text) ``` [ 返回一個適當的日期時間為給定的_text_。這個虛擬函數是所使用的日期時間編輯時，它需要解釋由用戶輸入的值的文本。 ](qdatetime.html) [**See also**](qdatetime.html) [textFromDateTime](qdatetimeedit.html#textFromDateTime)（）和[validate](qdatetimeedit.html#validate)（）。 ``` Sections QDateTimeEdit.displayedSections (self) ``` [ ``` QString QDateTimeEdit.displayFormat (self) ``` ``` bool QDateTimeEdit.event (self, QEvent?e) ``` ](index.htm) [從重新實現](index.htm)[QObject.event](qobject.html#event)（）。 ``` QString?input QDateTimeEdit.fixup (self, QString?input) ``` 從重新實現[QAbstractSpinBox.fixup](qabstractspinbox.html#fixup)（）。 ``` QDateTimeEdit.fixup (self, QString?input) ``` ``` QDateTimeEdit.focusInEvent (self, QFocusEvent?e) ``` 從重新實現[QWidget.focusInEvent](qwidget.html#focusInEvent)（）。 ``` bool QDateTimeEdit.focusNextPrevChild (self, bool?next) ``` 從重新實現[QWidget.focusNextPrevChild](qwidget.html#focusNextPrevChild)（）。 ``` QDateTimeEdit.initStyleOption (self, QStyleOptionSpinBox?option) ``` 初始化_option_與這QDataTimeEdit的值。當他們需要一個這種方法是有用的子類[QStyleOptionSpinBox](qstyleoptionspinbox.html)，但不希望在所有的信息填寫自己。 **See also** [QStyleOption.initFrom](qstyleoption.html#initFrom)（）。 ``` QDateTimeEdit.keyPressEvent (self, QKeyEvent?e) ``` 從重新實現[QWidget.keyPressEvent](qwidget.html#keyPressEvent)（）。 ``` QDate QDateTimeEdit.maximumDate (self) ``` [](qdate.html) ``` QDateTime QDateTimeEdit.maximumDateTime (self) ``` [](qdatetime.html) ``` QTime QDateTimeEdit.maximumTime (self) ``` [](qtime.html) ``` QDate QDateTimeEdit.minimumDate (self) ``` [](qdate.html) ``` QDateTime QDateTimeEdit.minimumDateTime (self) ``` [](qdatetime.html) ``` QTime QDateTimeEdit.minimumTime (self) ``` [ ``` QDateTimeEdit.mousePressEvent (self, QMouseEvent?event) ``` ](qtime.html) [從重新實現](qtime.html)[QWidget.mousePressEvent](qwidget.html#mousePressEvent)（）。 ``` QDateTimeEdit.paintEvent (self, QPaintEvent?event) ``` 從重新實現[QWidget.paintEvent](qwidget.html#paintEvent)（）。 ``` Section QDateTimeEdit.sectionAt (self, int?index) ``` [ 返回科_index_。 ](qdatetimeedit.html#Section-enum) [如果格式是'YYYY / MM / DD ' ， sectionAt （ 0 ）返回](qdatetimeedit.html#Section-enum)[YearSection](qdatetimeedit.html#Section-enum)， sectionAt （ 1 ）返回[MonthSection](qdatetimeedit.html#Section-enum)和sectionAt （2）返回[YearSection](qdatetimeedit.html#Section-enum)，此功能被引入Qt的4.3 。 ``` int QDateTimeEdit.sectionCount (self) ``` ``` QString QDateTimeEdit.sectionText (self, Section?s) ``` 從給定的返回文本_section_。 **See also** [currentSection](qdatetimeedit.html#currentSection-prop)（）。 ``` QDateTimeEdit.setCalendarPopup (self, bool?enable) ``` ``` QDateTimeEdit.setCalendarWidget (self, QCalendarWidget?calendarWidget) ``` 該_calendarWidget_說法有它的所有權轉移給Qt的。設置給定_calendarWidget_作為要用于日歷彈出的窗口小部件。編輯器不會自動把日歷窗口小部件的所有權。 **Note:** [calendarPopup](qdatetimeedit.html#calendarPopup-prop)設置日歷控件之前，必須設置為True。此功能被引入Qt的4.4 。 **See also** [calendarWidget](qdatetimeedit.html#calendarWidget)（）和[calendarPopup](qdatetimeedit.html#calendarPopup-prop)。 ``` 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](qdatetimeedit.html#minimumDate-prop)（）[maximumDate](qdatetimeedit.html#maximumDate-prop)（）[setMaximumDate](qdatetimeedit.html#maximumDate-prop)（）[clearMinimumDate](qdatetimeedit.html#minimumDate-prop)（）[setMinimumTime](qdatetimeedit.html#minimumTime-prop)（）[maximumTime](qdatetimeedit.html#maximumTime-prop)（）[setMaximumTime](qdatetimeedit.html#maximumTime-prop)（）[clearMinimumTime](qdatetimeedit.html#minimumTime-prop)（）和[QDate.isValid](qdate.html#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](qdatetimeedit.html#minimumDate-prop)（）[maximumDate](qdatetimeedit.html#maximumDate-prop)（）[setMaximumDate](qdatetimeedit.html#maximumDate-prop)（）[clearMinimumDate](qdatetimeedit.html#minimumDate-prop)（）[setMinimumTime](qdatetimeedit.html#minimumTime-prop)（）[maximumTime](qdatetimeedit.html#maximumTime-prop)（）[setMaximumTime](qdatetimeedit.html#maximumTime-prop)（）[clearMinimumTime](qdatetimeedit.html#minimumTime-prop)（）和[QDateTime.isValid](qdatetime.html#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](qdatetimeedit.html#Section-enum)此功能將取消選擇在編輯器中的所有文本。否則，此函數將移動光標和當前部分選定的部分。這個函數中引入了Qt 4.2中。 **See also** [currentSection](qdatetimeedit.html#currentSection-prop)（）。 ``` 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](qdatetimeedit.html#minimumDate-prop)（）[maximumDate](qdatetimeedit.html#maximumDate-prop)（）[setMaximumDate](qdatetimeedit.html#maximumDate-prop)（）[clearMinimumDate](qdatetimeedit.html#minimumDate-prop)（）[setMinimumTime](qdatetimeedit.html#minimumTime-prop)（）[maximumTime](qdatetimeedit.html#maximumTime-prop)（）[setMaximumTime](qdatetimeedit.html#maximumTime-prop)（）[clearMinimumTime](qdatetimeedit.html#minimumTime-prop)（）和[QTime.isValid](qtime.html#isValid)（）。 ``` QDateTimeEdit.setTimeSpec (self, Qt.TimeSpec?spec) ``` ``` QSize QDateTimeEdit.sizeHint (self) ``` [](qsize.html) [從重新實現](qsize.html)[QWidget.sizeHint](qwidget.html#sizeHint-prop)（）。 ``` QDateTimeEdit.stepBy (self, int?steps) ``` 從重新實現[QAbstractSpinBox.stepBy](qabstractspinbox.html#stepBy)（）。 ``` QAbstractSpinBox.StepEnabled QDateTimeEdit.stepEnabled (self) ``` [](index.htm) [從重新實現](index.htm)[QAbstractSpinBox.stepEnabled](qabstractspinbox.html#stepEnabled)（）。 ``` QString QDateTimeEdit.textFromDateTime (self, QDateTime?dt) ``` 這個虛函數所使用的日期時間編輯時，它需要顯示_dateTime_。如果你重新實現這一點，您可能還需要重新實現[validate](qdatetimeedit.html#validate)（）。 **See also** [dateTimeFromText](qdatetimeedit.html#dateTimeFromText)（）和[validate](qdatetimeedit.html#validate)（）。 ``` QTime QDateTimeEdit.time (self) ``` [](qtime.html) ``` Qt.TimeSpec QDateTimeEdit.timeSpec (self) ``` [ ``` (QValidator.State, QString?input, int?pos) QDateTimeEdit.validate (self, QString?input, int?pos) ``` ](qt.html#TimeSpec-enum) [從重新實現](qt.html#TimeSpec-enum)[QAbstractSpinBox.validate](qabstractspinbox.html#validate)（）。 ``` (QValidator.State, int?pos) QDateTimeEdit.validate (self, QString?input, int?pos) ``` ``` QDateTimeEdit.wheelEvent (self, QWheelEvent?e) ``` 從重新實現[QWidget.wheelEvent](qwidget.html#wheelEvent)（）。 * * * ## Qt Signal Documentation ``` void dateChanged (const QDate&) ``` 這是該信號的默認超載。這個信號被發射時的時間被改變。新的日期是在傳遞_date_。 ``` void dateTimeChanged (const QDateTime&) ``` 這是該信號的默認超載。這個信號被發射時的日期或時間而改變。新的日期和時間被傳遞_datetime_。 ``` void timeChanged (const QTime&) ``` 這是該信號的默認超載。這個信號被發射時的時間被改變。新的時間被傳遞_time_。