QDateTime Class Reference · PyQt4 中文文檔

# QDateTime Class Reference ## [[QtCore](index.htm) module] 該QDateTime類提供??日期和時間函數。[More...](#details) ### Methods * `__init__ (self)` * `__init__ (self, QDateTime?other)` * `__init__ (self, QDate)` * `__init__ (self, QDate?date, QTime?time, Qt.TimeSpec?timeSpec?=?Qt.LocalTime)` * `__init__ (self, int?y, int?m, int?d, int?h, int?m, int?s?=?0, int?msec?=?0, int?timeSpec?=?0)` * `QDateTime addDays (self, int?days)` * `QDateTime addMonths (self, int?months)` * `QDateTime addMSecs (self, int?msecs)` * `QDateTime addSecs (self, int?secs)` * `QDateTime addYears (self, int?years)` * `QDate date (self)` * `int daysTo (self, QDateTime)` * `bool isNull (self)` * `bool isValid (self)` * `int msecsTo (self, QDateTime)` * `int secsTo (self, QDateTime)` * `setDate (self, QDate?date)` * `setMSecsSinceEpoch (self, int?msecs)` * `setTime (self, QTime?time)` * `setTime_t (self, int?secsSince1Jan1970UTC)` * `setTimeSpec (self, Qt.TimeSpec?spec)` * `QTime time (self)` * `Qt.TimeSpec timeSpec (self)` * `QDateTime toLocalTime (self)` * `int toMSecsSinceEpoch (self)` * `datetime.datetime toPyDateTime (self)` * `QString toString (self, Qt.DateFormat?format?=?Qt.TextDate)` * `QString toString (self, QString?format)` * `int toTime_t (self)` * `QDateTime toTimeSpec (self, Qt.TimeSpec?spec)` * `QDateTime toUTC (self)` ### Static Methods * `QDateTime currentDateTime ()` * `QDateTime currentDateTimeUtc ()` * `int currentMSecsSinceEpoch ()` * `QDateTime fromMSecsSinceEpoch (int?msecs)` * `QDateTime fromString (QString?string, Qt.DateFormat?format?=?Qt.TextDate)` * `QDateTime fromString (QString?s, QString?format)` * `QDateTime fromTime_t (int?secsSince1Jan1970UTC)` ### Special Methods * `int __bool__ (self)` * `bool __eq__ (self, QDateTime?other)` * `bool __ge__ (self, QDateTime?other)` * `bool __gt__ (self, QDateTime?other)` * `int __hash__ (self)` * `bool __le__ (self, QDateTime?other)` * `bool __lt__ (self, QDateTime?other)` * `bool __ne__ (self, QDateTime?other)` * `str __repr__ (self)` * * * ## Detailed Description 這個類可以醃制。也可以使用一個Python的datetime對象，每當一個[QDateTime](qdatetime.html)預計。該QDateTime類提供??日期和時間函數。一個QDateTime對象包含一個日歷日期和時鐘時間（一個“日期時間” ）。它是一個組合[QDate](qdate.html)和[QTime](qtime.html)類。它可以從系統時鐘讀取當前的日期時間。它提供的功能來比較日期時間以及通過增加秒數，天，月或年操縱一個日期時間。一個QDateTime對象通常創建無論是在構造函數中給出的日期和時間明確，或者使用靜態函數[currentDateTime](qdatetime.html#currentDateTime)（），返回設定到系統時鐘的時間QDateTime對象。的日期和時間可以與被改變[setDate](qdatetime.html#setDate)（）和[setTime](qdatetime.html#setTime)（）。日期時間也可以使用設置[setTime_t](qdatetime.html#setTime_t)（）函數，它接受一個符合POSIX標準的“秒數以來00:00:00 1970年1月”的價值。該[fromString](qdatetime.html#fromString)（）函數返回一個QDateTime ，給定一個字符串，用于在字符串中解釋日期的日期格式。該[date](qdatetime.html#date)（）和[time](qdatetime.html#time)（）函數提供了訪問的日期和時間部分的日期時間的。相同的信息被提供以文本格式[toString](qdatetime.html#toString)（）函數。 QDateTime提供了一整套運營商來比較兩個QDateTime對象，其中較小的手段更早和更大的手段更高版本。你可以遞增（或遞減）日期時間按毫秒的使用給定的數[addMSecs](qdatetime.html#addMSecs)（），用秒[addSecs](qdatetime.html#addSecs)（），或者使用天[addDays](qdatetime.html#addDays)（）。同樣，您可以使用[addMonths](qdatetime.html#addMonths)（）和[addYears](qdatetime.html#addYears)（）。該[daysTo](qdatetime.html#daysTo)（）函數返回天兩個日期時間之間的數，[secsTo](qdatetime.html#secsTo)（）返回的秒數2日期時間之間，并[msecsTo](qdatetime.html#msecsTo)（）返回兩個日期時間之間的毫秒數。 QDateTime日期時間可作為存儲[local time](qt.html#TimeSpec-enum)或[UTC](qt.html#TimeSpec-enum)。[QDateTime.currentDateTime](qdatetime.html#currentDateTime)（）返回一個QDateTime表示為本地時間;使用[toUTC](qdatetime.html#toUTC)（）將其轉換為UTC。您也可以使用[timeSpec](qdatetime.html#timeSpec)（）來找出是否一個QDateTime對象存儲UTC時間或本地時間。操作如[addSecs](qdatetime.html#addSecs)（）和[secsTo](qdatetime.html#secsTo)（）都知道的日光節約時間（DST ）。 **Note:**QDateTime不佔閏秒。 #### Use of Gregorian and Julian Calendars [QDate](qdate.html)使用在所有語言環境公歷， 1582年10月開始的日期15 。對于日期截至及包括1582年10月4日，儒略歷被使用。這意味著有一個10天的差距在1582年10月4日和15日之間的內部日歷。當您使用QDateTime的日期在那個時代， 1582年10月4日之后的一天是1582年10月15日，和日期的差距是無效的。朱利安在這里使用的公歷轉換日期是首次引入公歷，由羅馬教皇格里高利十三日。這變化是沒有被普遍接受，一些地方只執行它在稍后的日期（如果有的話）。 QDateTime不采取任何這些歷史事實考慮在內。如果應用程序必須支持區域設置特定的約會系統，它必須這樣做對自己，記住要轉換使用儒略日的日期。 #### No Year 0 沒有0年。在這一年的日期將被視為無效。當年-1是今年“ 1基督之前”或“ 1日前電流的時代。 ” 0001-01-01前一天是12月31日， 1 BCE 。 #### Range of Valid Dates 有效的日期范圍是從1月2日， 4713 BCE ，到某個時候在今年1100萬CE認證。儒略日傳回[QDate.toJulianDay](qdate.html#toJulianDay)（）是一個數字，在連續的范圍從1到_overflow_，甚至跨越QDateTime的“日漏洞” 。它適合于應用程序，必須轉換QDateTime為日期在另一日歷系統，例如，希伯來文，伊斯蘭或中國使用。公歷中引入了世界各地不同的地方不同的日期。 QDateTime用途[QDate](qdate.html)存儲日期，所以它使用的公歷為所有區域設置，開始日期1582年10月15日。對于日期截至及包括1582年10月4日， QDateTime使用儒略歷。這意味著有一個10天的差距，在QDateTime歷1582年10月4日和15日之間。當您使用QDateTime的日期在那個時代， 1582年10月4日之后的一天是1582年10月15日，和日期的差距是無效的。 #### Use of System Timezone QDateTime使用系統的時區信息來確定與UTC本地時間的偏移量。如果系統沒有正確或不切合最新的配置， QDateTime會給出錯誤的結果也是如此。 #### Daylight Savings Time (DST) QDateTime時與夏令時處理考慮到了系統的時區信息。在現代的Unix系統，這意味著它時，應用正確的歷史DST數據的可能。在Windows和Windows CE ，那里的系統不支持DST的歷史數據，歷史精度不能保持相對的DST 。 DST同時考慮到有效的日期范圍是1970-01-01到現在，和規則到位正確處理DST ，直到2037年12月31日，但這些可能會改變。對于日期的范圍外時， QDateTime使_best guess_使用規則1970或2037年，但我們不能保證準確性。這意味著QDateTime沒有考慮到在一個區域的時區帳戶更改1970年以前，即使系統的時區數據庫支持的信息。 * * * ## Method Documentation ``` QDateTime.__init__ (self) ``` 構造一個空的日期時間（即空的日期和空時間）。一個空的日期時間是無效的，因為日期是無效的。 **See also** [isValid](qdatetime.html#isValid)（）。 ``` QDateTime.__init__ (self, QDateTime?other) ``` 構造一個日期時間與給定_date_時，有效時間（ 00:00:00.000 ），并設置[timeSpec](qdatetime.html#timeSpec)（）來[Qt.LocalTime](qt.html#TimeSpec-enum)。 ``` QDateTime.__init__ (self, QDate) ``` 構造一個日期時間與給定_date_和_time_，通過使用規定的時間規范_spec_。 If _date_是有效的和_time_不，時間將被設置為午夜。 ``` QDateTime.__init__ (self, QDate?date, QTime?time, Qt.TimeSpec?timeSpec?=?Qt.LocalTime) ``` 構造的一個副本_other_日期時間。 ``` QDateTime.__init__ (self, int?y, int?m, int?d, int?h, int?m, int?s?=?0, int?msec?=?0, int?timeSpec?=?0) ``` ``` QDateTime QDateTime.addDays (self, int?days) ``` [](qdatetime.html) [返回](qdatetime.html)[QDateTime](qdatetime.html)對象包含日期時間_ndays_天遲于該對象的日期時間（或更早，如果_ndays_是負的）。 **See also** [daysTo](qdatetime.html#daysTo)（）[addMonths](qdatetime.html#addMonths)（）[addYears](qdatetime.html#addYears)（）和[addSecs](qdatetime.html#addSecs)（）。 ``` QDateTime QDateTime.addMonths (self, int?months) ``` [](qdatetime.html) [返回](qdatetime.html)[QDateTime](qdatetime.html)對象包含日期時間_nmonths_個月后比這個對象的日期時間（或更早版本，如果_nmonths_是負的）。 **See also** [daysTo](qdatetime.html#daysTo)（）[addDays](qdatetime.html#addDays)（）[addYears](qdatetime.html#addYears)（）和[addSecs](qdatetime.html#addSecs)（）。 ``` QDateTime QDateTime.addMSecs (self, int?msecs) ``` [](qdatetime.html) [返回](qdatetime.html)[QDateTime](qdatetime.html)對象包含日期時間_msecs_毫秒遲于該對象的日期時間（或更早版本，如果_msecs_是負的）。 **See also** [addSecs](qdatetime.html#addSecs)（）[msecsTo](qdatetime.html#msecsTo)（）[addDays](qdatetime.html#addDays)（）[addMonths](qdatetime.html#addMonths)（）和[addYears](qdatetime.html#addYears)（）。 ``` QDateTime QDateTime.addSecs (self, int?secs) ``` [](qdatetime.html) [返回](qdatetime.html)[QDateTime](qdatetime.html)對象包含日期時間_s_秒遲于該對象的日期時間（或更早版本，如果_s_是負的）。 **See also** [addMSecs](qdatetime.html#addMSecs)（）[secsTo](qdatetime.html#secsTo)（）[addDays](qdatetime.html#addDays)（）[addMonths](qdatetime.html#addMonths)（）和[addYears](qdatetime.html#addYears)（）。 ``` QDateTime QDateTime.addYears (self, int?years) ``` [](qdatetime.html) [返回](qdatetime.html)[QDateTime](qdatetime.html)對象包含日期時間_nyears_年后比這個對象的日期時間（或更早版本，如果_nyears_是負的）。 **See also** [daysTo](qdatetime.html#daysTo)（）[addDays](qdatetime.html#addDays)（）[addMonths](qdatetime.html#addMonths)（）和[addSecs](qdatetime.html#addSecs)（）。 ``` QDateTime QDateTime.currentDateTime () ``` [ 返回當前日期時間，所報告的系統時鐘，在當地時區。 ](qdatetime.html) [**See also**](qdatetime.html) [currentDateTimeUtc](qdatetime.html#currentDateTimeUtc)（）[QDate.currentDate](qdate.html#currentDate)（）[QTime.currentTime](qtime.html#currentTime)（）和[toTimeSpec](qdatetime.html#toTimeSpec)（）。 ``` QDateTime QDateTime.currentDateTimeUtc () ``` [ 返回當前日期時間，所報告的系統時鐘，以UTC 。此功能被引入Qt的4.7 。 ](qdatetime.html) [**See also**](qdatetime.html) [currentDateTime](qdatetime.html#currentDateTime)（）[QDate.currentDate](qdate.html#currentDate)（）[QTime.currentTime](qtime.html#currentTime)（）和[toTimeSpec](qdatetime.html#toTimeSpec)（）。 ``` int QDateTime.currentMSecsSinceEpoch () ``` 返回毫秒自1970年以來-01- 01T00人數： 00:00世界標準時間。這個數字是像POSIX時間變量，但以毫秒為單位來代替。此功能被引入Qt的4.7 。 **See also** [currentDateTime](qdatetime.html#currentDateTime)（）[currentDateTimeUtc](qdatetime.html#currentDateTimeUtc)（）[toTime_t](qdatetime.html#toTime_t)（）和[toTimeSpec](qdatetime.html#toTimeSpec)（）。 ``` QDate QDateTime.date (self) ``` [ 返回日期時間的日期部分。 ](qdate.html) [**See also**](qdate.html) [setDate](qdatetime.html#setDate)（）[time](qdatetime.html#time)（）和[timeSpec](qdatetime.html#timeSpec)（）。 ``` int QDateTime.daysTo (self, QDateTime) ``` 返回從該日期時間的天數，以本_other_日期時間。如果_other_日期時間早于這個日期，返回的值是負的。 **See also** [addDays](qdatetime.html#addDays)（）[secsTo](qdatetime.html#secsTo)（）和[msecsTo](qdatetime.html#msecsTo)（）。 ``` QDateTime QDateTime.fromMSecsSinceEpoch (int?msecs) ``` [](qdatetime.html) [返回日期時間的日期和時間的毫秒數，_msecs_，自1970年以來-01- 01T00已通過： 00:00.000 ，協調世界時（](qdatetime.html)[Qt.UTC](qt.html#TimeSpec-enum)）。在不支持時區的系統，時間將被設置為如果本地時間是[Qt.UTC](qt.html#TimeSpec-enum)。注意，有可能的值_msecs_這個謊言之外的有效范圍[QDateTime](qdatetime.html)，正面和負面的。這個函數的行為是未定義的值。此功能被引入Qt的4.7 。 **See also** [toTime_t](qdatetime.html#toTime_t)（）和[setTime_t](qdatetime.html#setTime_t)（）。 ``` QDateTime QDateTime.fromString (QString?string, Qt.DateFormat?format?=?Qt.TextDate) ``` [](qdatetime.html) [返回](qdatetime.html)[QDateTime](qdatetime.html)由表示_string_使用_format_定，或無效的日期時間，如果這是不可能的。注意事項[Qt.TextDate](qt.html#DateFormat-enum)：建議您使用英文短的月份名稱（例如“揚” ）。雖然本地化月名也可以使用，它們依賴于用戶的區域設置。 ``` QDateTime QDateTime.fromString (QString?s, QString?format) ``` [](qdatetime.html) [返回](qdatetime.html)[QDateTime](qdatetime.html)由表示_string_使用_format_給予，或無效的日期時間，如果該字符串無法解析。這些表達式可以用于格式字符串的日期部分： | Expression | Output | | --- | --- | | d | the day as number without a leading zero (1 to 31) | | dd | the day as number with a leading zero (01 to 31) | | ddd | the abbreviated localized day name (e.g. 'Mon' to 'Sun'). Uses [QDate.shortDayName](qdate.html#shortDayName)(). | | dddd | the long localized day name (e.g. 'Monday' to 'Sunday'). Uses [QDate.longDayName](qdate.html#longDayName)(). | | M | the month as number without a leading zero (1-12) | | MM | the month as number with a leading zero (01-12) | | MMM | the abbreviated localized month name (e.g. 'Jan' to 'Dec'). Uses [QDate.shortMonthName](qdate.html#shortMonthName)(). | | MMMM | the long localized month name (e.g. 'January' to 'December'). Uses [QDate.longMonthName](qdate.html#longMonthName)(). | | yy | the year as two digit number (00-99) | | yyyy | the year as four digit number | **Note:**不同于其他版本的功能，日期和月份名稱必須在用戶的本地語言來給出。它是唯一可以使用的英文名稱，如果用戶的語言是英語。這些表達式可以用于格式字符串的時間部分： | Expression | Output | | --- | --- | | h | the hour without a leading zero (0 to 23 or 1 to 12 if AM/PM display) | | hh | the hour with a leading zero (00 to 23 or 01 to 12 if AM/PM display) | | H | the hour without a leading zero (0 to 23, even with AM/PM display) | | HH | the hour with a leading zero (00 to 23, even with AM/PM display) | | m | the minute without a leading zero (0 to 59) | | mm | the minute with a leading zero (00 to 59) | | s | the second without a leading zero (0 to 59) | | ss | the second with a leading zero (00 to 59) | | z | the milliseconds without leading zeroes (0 to 999) | | zzz | the milliseconds with leading zeroes (000 to 999) | | AP or A | interpret as an AM/PM time. _AP_ must be either "AM" or "PM". | | ap or a | Interpret as an AM/PM time. _ap_ must be either "am" or "pm". | 所有其他輸入的字符將被視為文本。括在singlequotes任何字符序列也將被視為文本，而不是被用作表達。 ``` [QTime](qtime.html) time1 = [QTime](qtime.html).fromString("131", "HHh"); // time1 is 13:00:00 [QTime](qtime.html) time1 = [QTime](qtime.html).fromString("1apA", "1amAM"); // time1 is 01:00:00 [QDateTime](qdatetime.html) dateTime2 = [QDateTime](qdatetime.html).fromString("M1d1y9800:01:02", "'M'M'd'd'y'yyhh:mm:ss"); // dateTime is 1 January 1998 00:01:02 ``` 如果該格式不被滿足的無效[QDateTime](qdatetime.html)返回。沒有前導零（ D， M，H ， M，S ， Z）的表達式將是貪婪的。這意味著，他們將使用兩個數字，即使這將使他們的范圍之外和/或離開過幾位其他部分。 ``` [QDateTime](qdatetime.html) dateTime = [QDateTime](qdatetime.html).fromString("130", "Mm"); // invalid ``` 這可能意味著1月1日00:30.50但M將搶兩位數。對于未在格式表示任何領域使用以下缺省值： | Field | Default value | | --- | --- | | Year | 1900 | | Month | 1 (January) | | Day | 1 | | Hour | 0 | | Minute | 0 | | Second | 0 | 例如： ``` [QDateTime](qdatetime.html) dateTime = [QDateTime](qdatetime.html).fromString("1.30.1", "M.d.s"); // dateTime is January 30 in 1900 at 00:00:01. ``` [QDateTime.toString](qdatetime.html#toString)（）[QTime.toString](qtime.html#toString)（） **See also** [QDate.fromString](qdate.html#fromString)（）[QTime.fromString](qtime.html#fromString)（）和[QDate.toString](qdate.html#toString)（）。 ``` QDateTime QDateTime.fromTime_t (int?secsSince1Jan1970UTC) ``` [](qdatetime.html) [返回日期時間的日期和時間是多少_seconds_自1970年以來-01- 01T00已通過：00:00 ，協調世界時（](qdatetime.html)[Qt.UTC](qt.html#TimeSpec-enum)）。在不支持時區的系統，時間將被設置為如果本地時間是[Qt.UTC](qt.html#TimeSpec-enum)。這個函數中引入了Qt 4.2中。 **See also** [toTime_t](qdatetime.html#toTime_t)（）和[setTime_t](qdatetime.html#setTime_t)（）。 ``` bool QDateTime.isNull (self) ``` 返回True如果這兩個日期和時間為空，否則返回False 。一個空的日期時間是無效的。 **See also** [QDate.isNull](qdate.html#isNull)（）[QTime.isNull](qtime.html#isNull)（）和[isValid](qdatetime.html#isValid)（）。 ``` bool QDateTime.isValid (self) ``` 返回True如果這兩個日期和時間都是有效的，否則返回False 。 **See also** [QDate.isValid](qdate.html#isValid)（）和[QTime.isValid](qtime.html#isValid)（）。 ``` int QDateTime.msecsTo (self, QDateTime) ``` 返回的毫秒數從這個日期時間到_other_日期時間。如果_other_日期時間早于這個日期，返回的值是負的。前執行比較，這兩個日期時間轉換為[Qt.UTC](qt.html#TimeSpec-enum)以保證結果是正確的，如果兩個日期時間中的一個已經日光節約時間（DST ）和其他沒有。此功能被引入Qt的4.7 。 **See also** [addMSecs](qdatetime.html#addMSecs)（）[daysTo](qdatetime.html#daysTo)（）和[QTime.msecsTo](qtime.html#msecsTo)（）。 ``` int QDateTime.secsTo (self, QDateTime) ``` 返回的秒數從這個日期到_other_日期時間。如果_other_日期時間早于這個日期，返回的值是負的。前執行比較，這兩個日期時間轉換為[Qt.UTC](qt.html#TimeSpec-enum)以保證結果是正確的，如果兩個日期時間中的一個已經日光節約時間（DST ）和其他沒有。例如： ``` [QDateTime](qdatetime.html) now = [QDateTime](qdatetime.html).currentDateTime(); [QDateTime](qdatetime.html) xmas([QDate](qdate.html)(now.date().year(), 12, 25), [QTime](qtime.html)(0, 0)); qDebug("There are %d seconds to Christmas", now.secsTo(xmas)); ``` **See also** [addSecs](qdatetime.html#addSecs)（）[daysTo](qdatetime.html#daysTo)（）和[QTime.secsTo](qtime.html#secsTo)（）。 ``` QDateTime.setDate (self, QDate?date) ``` 設置此日期時間的日期部分，以_date_。如果沒有時間被設置，它被設定為午夜。 **See also** [date](qdatetime.html#date)（）[setTime](qdatetime.html#setTime)（）和[setTimeSpec](qdatetime.html#setTimeSpec)（）。 ``` QDateTime.setMSecsSinceEpoch (self, int?msecs) ``` 設置給定的毫秒數的日期和時間，_msecs_，自1970年以來-01- 01T00已通過： 00:00.000 ，協調世界時（[Qt.UTC](qt.html#TimeSpec-enum)）。在不支持時區，此功能系統的行為就好像本地時間分別為[Qt.UTC](qt.html#TimeSpec-enum)。注意，有可能的值_msecs_這個謊言之外的有效范圍[QDateTime](qdatetime.html)，正面和負面的。這個函數的行為是未定義的值。此功能被引入Qt的4.7 。 **See also** [toMSecsSinceEpoch](qdatetime.html#toMSecsSinceEpoch)（）和[setTime_t](qdatetime.html#setTime_t)（）。 ``` QDateTime.setTime (self, QTime?time) ``` 設置此日期時間的時間部分_time_。 **See also** [time](qdatetime.html#time)（）[setDate](qdatetime.html#setDate)（）和[setTimeSpec](qdatetime.html#setTimeSpec)（）。 ``` QDateTime.setTime_t (self, int?secsSince1Jan1970UTC) ``` 設置給定數量的日期和時間_seconds_自1970年以來-01- 01T00已通過：00:00 ，協調世界時（[Qt.UTC](qt.html#TimeSpec-enum)）。在不支持時區，此功能系統的行為就好像本地時間分別為[Qt.UTC](qt.html#TimeSpec-enum)。 **See also** [toTime_t](qdatetime.html#toTime_t)（）。 ``` QDateTime.setTimeSpec (self, Qt.TimeSpec?spec) ``` 設定這個日期時間用于時間規范_spec_。 **See also** [timeSpec](qdatetime.html#timeSpec)（）[setDate](qdatetime.html#setDate)（）[setTime](qdatetime.html#setTime)（）和[Qt.TimeSpec](qt.html#TimeSpec-enum)。 ``` QTime QDateTime.time (self) ``` [ 返回日期時間的時間部分。 ](qtime.html) [**See also**](qtime.html) [setTime](qdatetime.html#setTime)（）[date](qdatetime.html#date)（）和[timeSpec](qdatetime.html#timeSpec)（）。 ``` Qt.TimeSpec QDateTime.timeSpec (self) ``` [ 返回日期時間的時間規范。 ](qt.html#TimeSpec-enum) [**See also**](qt.html#TimeSpec-enum) [setTimeSpec](qdatetime.html#setTimeSpec)（）[date](qdatetime.html#date)（）[time](qdatetime.html#time)（）和[Qt.TimeSpec](qt.html#TimeSpec-enum)。 ``` QDateTime QDateTime.toLocalTime (self) ``` [](qdatetime.html) [返回包含此日期時間的日期和時間信息的日期時間，但使用指定的](qdatetime.html)[Qt.LocalTime](qt.html#TimeSpec-enum)的定義。 **See also** [toTimeSpec](qdatetime.html#toTimeSpec)（）。 ``` int QDateTime.toMSecsSinceEpoch (self) ``` 返回日期時間為自1970年以來-01- 01T00已通過的毫秒數： 00:00.000 ，協調世界時（[Qt.UTC](qt.html#TimeSpec-enum)）。在不支持時區的系統，這個功能的行為就好像本地時間分別為[Qt.UTC](qt.html#TimeSpec-enum)。此函數的行為是不確定的，如果存儲在此對象的日期時間是無效的。然而，對于所有有效日期，此函數返回一個唯一的值。此功能被引入Qt的4.7 。 **See also** [toTime_t](qdatetime.html#toTime_t)（）和[setMSecsSinceEpoch](qdatetime.html#setMSecsSinceEpoch)（）。 ``` datetime.datetime QDateTime.toPyDateTime (self) ``` ``` QString QDateTime.toString (self, Qt.DateFormat?format?=?Qt.TextDate) ``` 返回日期時間為一個字符串。該_format_參數決定了結果字符串的格式。這些表達式可以用于日期： | Expression | Output | | --- | --- | | d | the day as number without a leading zero (1 to 31) | | dd | the day as number with a leading zero (01 to 31) | | ddd | the abbreviated localized day name (e.g. 'Mon' to 'Sun'). Uses [QDate.shortDayName](qdate.html#shortDayName)(). | | dddd | the long localized day name (e.g. 'Monday' to '[Qt.Sunday](qt.html#DayOfWeek-enum)'). Uses [QDate.longDayName](qdate.html#longDayName)(). | | M | the month as number without a leading zero (1-12) | | MM | the month as number with a leading zero (01-12) | | MMM | the abbreviated localized month name (e.g. 'Jan' to 'Dec'). Uses [QDate.shortMonthName](qdate.html#shortMonthName)(). | | MMMM | the long localized month name (e.g. 'January' to 'December'). Uses [QDate.longMonthName](qdate.html#longMonthName)(). | | yy | the year as two digit number (00-99) | | yyyy | the year as four digit number | 這些表達式可以用于時間： | Expression | Output | | --- | --- | | h | the hour without a leading zero (0 to 23 or 1 to 12 if AM/PM display) | | hh | the hour with a leading zero (00 to 23 or 01 to 12 if AM/PM display) | | m | the minute without a leading zero (0 to 59) | | mm | the minute with a leading zero (00 to 59) | | s | the second without a leading zero (0 to 59) | | ss | the second with a leading zero (00 to 59) | | z | the milliseconds without leading zeroes (0 to 999) | | zzz | the milliseconds with leading zeroes (000 to 999) | | AP | use AM/PM display. _AP_ will be replaced by either "AM" or "PM". | | ap | use am/pm display. _ap_ will be replaced by either "am" or "pm". | 所有其它輸入的字符將被忽略。括在singlequotes任何字符序列將被視為文本，而不是被用作表達。連續兩singlequotes （ “''” ）是由singlequote輸出所取代。例如格式字符串（假設[QDateTime](qdatetime.html)是2001年5月21日14點13分09秒）： | Format | Result | | --- | --- | | dd.MM.yyyy | 21.05.2001 | | ddd MMMM d yy | Tue May 21 01 | | hh:mm:ss.zzz | 14:13:09.042 | | h:m:s ap | 2:13:9 pm | 如果日期時間是無效的，空字符串將被返回。 **See also** [QDate.toString](qdate.html#toString)（）和[QTime.toString](qtime.html#toString)（）。 ``` QString QDateTime.toString (self, QString?format) ``` 這是一個重載函數。返回日期時間的字符串中的_format_給出。如果_format_ is [Qt.TextDate](qt.html#DateFormat-enum)，該字符串被格式化的默認方式。[QDate.shortDayName](qdate.html#shortDayName)（）[QDate.shortMonthName](qdate.html#shortMonthName)（）和[QTime.toString](qtime.html#toString)（）是用來產生該字符串，所以日期和月份名稱將本地化的名稱。這種格式的一個例子是“周三5月20日03:40:13 1998” 。如果_format_ is [Qt.ISODate](qt.html#DateFormat-enum)，字符串格式對應于ISO 8601擴展規格的日期和時間的表示，采取的形式為YYYY- MM- DDTHH ： MM：SS [Z | [ + | - ] HH ： MM] ，視[timeSpec](qdatetime.html#timeSpec)（）的[QDateTime](qdatetime.html)。如果[timeSpec](qdatetime.html#timeSpec)（）是[Qt.UTC](qt.html#TimeSpec-enum)，Z將被附加到字符串;如果[timeSpec](qdatetime.html#timeSpec)（）是[Qt.OffsetFromUTC](qt.html#TimeSpec-enum)相對于UTC的偏移，以小時和分鐘會被附加到字符串。如果_format_ is [Qt.SystemLocaleShortDate](qt.html#DateFormat-enum) or [Qt.SystemLocaleLongDate](qt.html#DateFormat-enum)，字符串格式取決于系統的區域設置。相同的調用[QLocale.system](qlocale.html#system)（）。的toString （日期時間，[QLocale.ShortFormat](qlocale.html#FormatType-enum)）或[QLocale.system](qlocale.html#system)（）。的toString （日期時間，[QLocale.LongFormat](qlocale.html#FormatType-enum)）。如果_format_ is [Qt.DefaultLocaleShortDate](qt.html#DateFormat-enum) or [Qt.DefaultLocaleLongDate](qt.html#DateFormat-enum)，字符串格式依賴于默認應用程序的語言環境。這就是語言環境設置[QLocale.setDefault](qlocale.html#setDefault)（）或系統區域設置，如果沒有默認區域設置已定。相同的調用QLocale （）。的toString （日期時間，[QLocale.ShortFormat](qlocale.html#FormatType-enum)）或QLocale （）。的toString （日期時間，[QLocale.LongFormat](qlocale.html#FormatType-enum)）。如果日期時間是無效的，空字符串將被返回。 **Warning:**該[Qt.ISODate](qt.html#DateFormat-enum)格式僅適用于年范圍為0 ?9999 。這種限制可能適用于區域設置的格式為好，這取決于區域設置。 **See also** [QDate.toString](qdate.html#toString)（）[QTime.toString](qtime.html#toString)（）和[Qt.DateFormat](qt.html#DateFormat-enum)。 ``` int QDateTime.toTime_t (self) ``` 返回日期時間為自1970年以來-01- 01T00已通過秒數：00:00 ，協調世界時（[Qt.UTC](qt.html#TimeSpec-enum)）。在不支持時區的系統，這個功能的行為就好像本地時間分別為[Qt.UTC](qt.html#TimeSpec-enum)。 **Note:**這個函數返回一個32位的無符號整數，所以在1970年之前它不支持日期，但它2038- 01 - 19T03后支持日期： 14:06 ，這可能不是有效的time_t值。通過這些time_t的值的系統功能時一定要小心，這可能將其解釋為負的日期。如果日期是輸入1970 -01- 01T00外： 00:00至2106 - 02 - 07T06 ： 28:14 ，該函數返回-1轉換為一個無符號整數（即0xFFFFFFFF的）。為了得到一個擴展量程，使用[toMSecsSinceEpoch](qdatetime.html#toMSecsSinceEpoch)（）。 **See also** [toMSecsSinceEpoch](qdatetime.html#toMSecsSinceEpoch)（）和[setTime_t](qdatetime.html#setTime_t)（）。 ``` QDateTime QDateTime.toTimeSpec (self, Qt.TimeSpec?spec) ``` [ 返回此日期時間的設定為使用給定的時間副本_specification_。 ](qdatetime.html) [**See also**](qdatetime.html) [timeSpec](qdatetime.html#timeSpec)（）[toUTC](qdatetime.html#toUTC)（）和[toLocalTime](qdatetime.html#toLocalTime)（）。 ``` QDateTime QDateTime.toUTC (self) ``` [](qdatetime.html) [返回包含此日期時間的日期和時間信息的日期時間，但使用指定的](qdatetime.html)[Qt.UTC](qt.html#TimeSpec-enum)的定義。 **See also** [toTimeSpec](qdatetime.html#toTimeSpec)（）。 ``` int QDateTime.__bool__ (self) ``` ``` bool QDateTime.__eq__ (self, QDateTime?other) ``` ``` bool QDateTime.__ge__ (self, QDateTime?other) ``` ``` bool QDateTime.__gt__ (self, QDateTime?other) ``` ``` int QDateTime.__hash__ (self) ``` ``` bool QDateTime.__le__ (self, QDateTime?other) ``` ``` bool QDateTime.__lt__ (self, QDateTime?other) ``` ``` bool QDateTime.__ne__ (self, QDateTime?other) ``` ``` str QDateTime.__repr__ (self) ```