?? qdatetime.html
字號:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/reggie/tmp/qt-3.0-reggie-5401/qt-x11-commercial-3.0.5/src/tools/qdatetime.cpp:1672 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<meta name="Translator" content="Cavendish">
<meta name="Qt zh_CN Documents Website" content="http://www.qiliang.net/qt">
<title>QDateTime類</title>
<style type="text/css"><!--
h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; font-family: "Times New Roman" }
--></style>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
<a href="index.html">
<font color="#004faf">主頁</font></a>
| <a href="classes.html">
<font color="#004faf">所有的類</font></a>
| <a href="mainclasses.html">
<font color="#004faf">主要的類</font></a>
| <a href="annotated.html">
<font color="#004faf">注釋的類</font></a>
| <a href="groups.html">
<font color="#004faf">分組的類</font></a>
| <a href="functions.html">
<font color="#004faf">函數</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table>
<h1 align=center>QDateTime類參考</h1>
<p>QDateTime類提供了日期和時間功能。
<a href="#details">詳情請見……</a>
<p><tt>#include <<a href="qdatetime-h.html">qdatetime.h</a>></tt>
<p><a href="qdatetime-members.html">所有成員函數的列表。</a>
<h2>公有成員</h2>
<ul>
<li><div class=fn><a href="#QDateTime"><b>QDateTime</b></a> ()</div></li>
<li><div class=fn><a href="#QDateTime-2"><b>QDateTime</b></a> ( const QDate & date )</div></li>
<li><div class=fn><a href="#QDateTime-3"><b>QDateTime</b></a> ( const QDate & date, const QTime & time )</div></li>
<li><div class=fn>bool <a href="#isNull"><b>isNull</b></a> () const</div></li>
<li><div class=fn>bool <a href="#isValid"><b>isValid</b></a> () const</div></li>
<li><div class=fn>QDate <a href="#date"><b>date</b></a> () const</div></li>
<li><div class=fn>QTime <a href="#time"><b>time</b></a> () const</div></li>
<li><div class=fn>void <a href="#setDate"><b>setDate</b></a> ( const QDate & date )</div></li>
<li><div class=fn>void <a href="#setTime"><b>setTime</b></a> ( const QTime & time )</div></li>
<li><div class=fn>void <a href="#setTime_t"><b>setTime_t</b></a> ( uint secsSince1Jan1970UTC )</div></li>
<li><div class=fn>QString <a href="#toString-2"><b>toString</b></a> ( Qt::DateFormat f = Qt::TextDate ) const</div></li>
<li><div class=fn>QString <a href="#toString"><b>toString</b></a> ( const QString & format ) const</div></li>
<li><div class=fn>QDateTime <a href="#addDays"><b>addDays</b></a> ( int ndays ) const</div></li>
<li><div class=fn>QDateTime <a href="#addMonths"><b>addMonths</b></a> ( int nmonths ) const</div></li>
<li><div class=fn>QDateTime <a href="#addYears"><b>addYears</b></a> ( int nyears ) const</div></li>
<li><div class=fn>QDateTime <a href="#addSecs"><b>addSecs</b></a> ( int nsecs ) const</div></li>
<li><div class=fn>int <a href="#daysTo"><b>daysTo</b></a> ( const QDateTime & dt ) const</div></li>
<li><div class=fn>int <a href="#secsTo"><b>secsTo</b></a> ( const QDateTime & dt ) const</div></li>
<li><div class=fn>bool <a href="#operator-eq-eq"><b>operator==</b></a> ( const QDateTime & dt ) const</div></li>
<li><div class=fn>bool <a href="#operator!-eq"><b>operator!=</b></a> ( const QDateTime & dt ) const</div></li>
<li><div class=fn>bool <a href="#operator-lt"><b>operator<</b></a> ( const QDateTime & dt ) const</div></li>
<li><div class=fn>bool <a href="#operator-lt-eq"><b>operator<=</b></a> ( const QDateTime & dt ) const</div></li>
<li><div class=fn>bool <a href="#operator-gt"><b>operator></b></a> ( const QDateTime & dt ) const</div></li>
<li><div class=fn>bool <a href="#operator-gt-eq"><b>operator>=</b></a> ( const QDateTime & dt ) const</div></li>
</ul>
<h2>靜態公有成員</h2>
<ul>
<li><div class=fn>QDateTime <a href="#currentDateTime"><b>currentDateTime</b></a> ()</div></li>
<li><div class=fn>QDateTime <a href="#fromString"><b>fromString</b></a> ( const QString & s, Qt::DateFormat f = Qt::TextDate )</div></li>
</ul>
<h2>相關函數</h2>
<ul>
<li><div class=fn>QDataStream & <a href="#operator-lt-lt"><b>operator<<</b></a> ( QDataStream & s, const QDateTime & dt )</div></li>
<li><div class=fn>QDataStream & <a href="#operator-gt-gt"><b>operator>></b></a> ( QDataStream & s, QDateTime & dt )</div></li>
</ul>
<hr><a name="details"></a><h2>詳細描述</h2>
QDateTime類提供了日期和時間功能。
<p>
<p> QDateTime對象包含一個日歷日期和一個時鐘時間（一個“日期時間”）。它是<a href="qdate.html">QDate</a>和<a href="qtime.html">QTime</a>兩個類的組合。它可以從系統時鐘中讀取當前日期時間。它提供比較日期時間和操作日期時間的函數，比如加上一定數量的秒、天、月或年。
<p> QDateTime對象通常可以由明白地給定的日期和時間來創建，或者使用靜態函數<a href="#currentDateTime">currentDateTime</a>()讓QDateTime對象包含系統時鐘的日期時間。日期時間也可以由<a href="#setDate">setDate</a>()和<a href="#setTime">setTime</a>()來改變。日期時間也可以通過使用<a href="#setTime_t">setTime_t</a>()函數來得到一個POSIX標準的時間，它表示的是自從1970年1月1日00:00:00以來的秒數。<a href="#fromString">fromString</a>()函數通過一個給定的字符串和在字符串中日期時間格式的間隔說明就可以返回一個QDateTime。
<p> <a href="#date">date</a>()和<a href="#time">time</a>()函數提供了對日期和時間的訪問。<a href="#toString">toString</a>()提供了文本格式的相同信息。
<p> QDateTime提供了一整套的操作符來比較兩個QDateTime對象，在這里小于表示早一些，大于表示晚一些。
<p> 你可以使用<a href="#addSecs">addSecs</a>()或<a href="#addDays">addDays</a>()給一個日期增加（或減少）一個給定的秒數或天數。相似地你可以使用<a href="#addMonths">addMonths</a>()和<a href="#addYears">addYears</a>()。<a href="#daysTo">daysTo</a>()函數返回兩個日期時間之間的天數，sectTo()返回兩個日期時間之間的秒數。
<p> 日期時間對象的范圍由<a href="qdate.html">QDate</a>和<a href="qtime.html">QTime</a>對象的范圍約束。
<p> <p>也可以參考<a href="qdate.html">QDate</a>、<a href="qtime.html">QTime</a>、<a href="qdatetimeedit.html">QDateTimeEdit</a>和<a href="time.html">時間和日期</a>。
<hr><h2>成員函數文檔</h2>
<h3 class=fn><a name="QDateTime"></a>QDateTime::QDateTime ()
</h3>
<p> 構造一個零日期時間（比如，零日期和零時間）。一個零日期時間是無效的，因為零日期是無效的。
<p> <p>也可以參考<a href="#isValid">isValid</a>()。
<h3 class=fn><a name="QDateTime-2"></a>QDateTime::QDateTime ( const <a href="qdate.html">QDate</a> & date )
</h3>
構造一個日期為<em>date</em>和零時間（00:00:00.000）的日期時間。
<h3 class=fn><a name="QDateTime-3"></a>QDateTime::QDateTime ( const <a href="qdate.html">QDate</a> & date, const <a href="qtime.html">QTime</a> & time )
</h3>
構造一個日期為<em>date</em>和時間為<em>time</em>的日期時間。
<h3 class=fn><a href="qdatetime.html">QDateTime</a> <a name="addDays"></a>QDateTime::addDays ( int ndays ) const
</h3>
返回這個日期時間對象<em>ndays</em>天之后的一個日期時間對象（或者<em>ndays</em>天之前的，如果它是一個負數）。
<p> <p>也可以參考<a href="#daysTo">daysTo</a>()、<a href="#addMonths">addMonths</a>()、<a href="#addYears">addYears</a>()和<a href="#addSecs">addSecs</a>()。
<h3 class=fn><a href="qdatetime.html">QDateTime</a> <a name="addMonths"></a>QDateTime::addMonths ( int nmonths ) const
</h3>
返回這個日期時間對象<em>nmonths</em>月之后的一個日期時間對象（或者<em>nmonths</em>月之前的，如果它是一個負數）。
<p> <p>也可以參考<a href="#daysTo">daysTo</a>()、<a href="#addDays">addDays</a>()、<a href="#addYears">addYears</a>()和<a href="#addSecs">addSecs</a>()。
<h3 class=fn><a href="qdatetime.html">QDateTime</a> <a name="addSecs"></a>QDateTime::addSecs ( int nsecs ) const
</h3>
返回這個日期時間對象<em>nsecs</em>秒之后的一個日期時間對象（或者<em>nsecs</em>秒之前的，如果它是一個負數）。
<p> <p>也可以參考<a href="#secsTo">secsTo</a>()、<a href="#addDays">addDays</a>()、<a href="#addMonths">addMonths</a>()和<a href="#addYears">addYears</a>()。
<p>實例：<a href="listviews-example.html#x323">listviews/listviews.cpp</a>。
<h3 class=fn><a href="qdatetime.html">QDateTime</a> <a name="addYears"></a>QDateTime::addYears ( int nyears ) const
</h3>
返回這個日期時間對象<em>nyears</em>年之后的一個日期時間對象（或者<em>nyears</em>年之前的，如果它是一個負數）。
<p> <p>也可以參考<a href="#daysTo">daysTo</a>()、<a href="#addDays">addDays</a>()、<a href="#addMonths">addMonths</a>()和<a href="#addSecs">addSecs</a>()。
<h3 class=fn><a href="qdatetime.html">QDateTime</a> <a name="currentDateTime"></a>QDateTime::currentDateTime ()<tt> [靜態]</tt>
</h3>
返回當前日期時間，來自于系統時鐘。
<p> <p>也可以參考<a href="qdate.html#currentDate">QDate::currentDate</a>()和<a href="qtime.html#currentTime">QTime::currentTime</a>()。
<p>實例：<a href="listviews-example.html#x324">listviews/listviews.cpp</a>。
<h3 class=fn><a href="qdate.html">QDate</a> <a name="date"></a>QDateTime::date () const
</h3>
<p> 返回日期時間的日期部分。
<p> <p>也可以參考<a href="#setDate">setDate</a>()和<a href="#time">time</a>()。
<h3 class=fn>int <a name="daysTo"></a>QDateTime::daysTo ( const <a href="qdatetime.html">QDateTime</a> & dt ) const
</h3>
返回這個日期時間到<em>dt</em>的天數（如果<em>dt</em>早于這個日期時間，返回的為負數）。
<p> <p>也可以參考<a href="#addDays">addDays</a>()和<a href="#secsTo">secsTo</a>()。
<h3 class=fn><a href="qdatetime.html">QDateTime</a> <a name="fromString"></a>QDateTime::fromString ( const <a href="qstring.html">QString</a> & s, <a href="qt.html#DateFormat-enum">Qt::DateFormat</a> f = Qt::TextDate )<tt> [靜態]</tt>
</h3>
通過給定的字符串<em>s</em>，使用格式<em>f</em>，返回這個QDateTime，或者如果這是不可能的話返回一個無效的日期時間。
<p> 注意Qt::LocalDate在這里不能使用。
<p> 注意Qt::TextDate：它被推薦使用英語中的月的縮寫格式（比如Jan）。本地的月名稱也可以被使用，但這取決于用戶的本地設置。
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -