?? qdate.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:202 -->
<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>QDate類</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>QDate類參考</h1>
<p>QDate類提供了日期功能。
<a href="#details">詳情請見……</a>
<p><tt>#include <<a href="qdatetime-h.html">qdatetime.h</a>></tt>
<p><a href="qdate-members.html">所有成員函數的列表。</a>
<h2>公有成員</h2>
<ul>
<li><div class=fn><a href="#QDate"><b>QDate</b></a> ()</div></li>
<li><div class=fn><a href="#QDate-2"><b>QDate</b></a> ( int y, int m, int d )</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>int <a href="#year"><b>year</b></a> () const</div></li>
<li><div class=fn>int <a href="#month"><b>month</b></a> () const</div></li>
<li><div class=fn>int <a href="#day"><b>day</b></a> () const</div></li>
<li><div class=fn>int <a href="#dayOfWeek"><b>dayOfWeek</b></a> () const</div></li>
<li><div class=fn>int <a href="#dayOfYear"><b>dayOfYear</b></a> () const</div></li>
<li><div class=fn>int <a href="#daysInMonth"><b>daysInMonth</b></a> () const</div></li>
<li><div class=fn>int <a href="#daysInYear"><b>daysInYear</b></a> () const</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>bool <a href="#setYMD"><b>setYMD</b></a> ( int y, int m, int d )</div></li>
<li><div class=fn>QDate <a href="#addDays"><b>addDays</b></a> ( int ndays ) const</div></li>
<li><div class=fn>QDate <a href="#addMonths"><b>addMonths</b></a> ( int nmonths ) const</div></li>
<li><div class=fn>QDate <a href="#addYears"><b>addYears</b></a> ( int nyears ) const</div></li>
<li><div class=fn>int <a href="#daysTo"><b>daysTo</b></a> ( const QDate & d ) const</div></li>
<li><div class=fn>bool <a href="#operator-eq-eq"><b>operator==</b></a> ( const QDate & d ) const</div></li>
<li><div class=fn>bool <a href="#operator!-eq"><b>operator!=</b></a> ( const QDate & d ) const</div></li>
<li><div class=fn>bool <a href="#operator-lt"><b>operator<</b></a> ( const QDate & d ) const</div></li>
<li><div class=fn>bool <a href="#operator-lt-eq"><b>operator<=</b></a> ( const QDate & d ) const</div></li>
<li><div class=fn>bool <a href="#operator-gt"><b>operator></b></a> ( const QDate & d ) const</div></li>
<li><div class=fn>bool <a href="#operator-gt-eq"><b>operator>=</b></a> ( const QDate & d ) const</div></li>
</ul>
<h2>靜態公有成員</h2>
<ul>
<li><div class=fn>QString monthName ( int month ) <em>(obsolete)</em></div></li>
<li><div class=fn>QString dayName ( int weekday ) <em>(obsolete)</em></div></li>
<li><div class=fn>QString <a href="#shortMonthName"><b>shortMonthName</b></a> ( int month )</div></li>
<li><div class=fn>QString <a href="#shortDayName"><b>shortDayName</b></a> ( int weekday )</div></li>
<li><div class=fn>QString <a href="#longMonthName"><b>longMonthName</b></a> ( int month )</div></li>
<li><div class=fn>QString <a href="#longDayName"><b>longDayName</b></a> ( int weekday )</div></li>
<li><div class=fn>QDate <a href="#currentDate"><b>currentDate</b></a> ()</div></li>
<li><div class=fn>QDate <a href="#fromString"><b>fromString</b></a> ( const QString & s, Qt::DateFormat f = Qt::TextDate )</div></li>
<li><div class=fn>bool <a href="#isValid-2"><b>isValid</b></a> ( int y, int m, int d )</div></li>
<li><div class=fn>bool <a href="#leapYear"><b>leapYear</b></a> ( int y )</div></li>
</ul>
<h2>相關函數</h2>
<ul>
<li><div class=fn>QDataStream & <a href="#operator-lt-lt"><b>operator<<</b></a> ( QDataStream & s, const QDate & d )</div></li>
<li><div class=fn>QDataStream & <a href="#operator-gt-gt"><b>operator>></b></a> ( QDataStream & s, QDate & d )</div></li>
</ul>
<hr><a name="details"></a><h2>詳細描述</h2>
QDate類提供了日期功能。
<p>
<p> QDate對象包含日歷日期，比如現代西方（教皇格列高利一世的）日歷年、月和日的數字。它可以從系統時鐘中讀取當前日期。它提供比較日期和操作日期的函數，比如加上一定數量的天、月或年。
<p> QDate對象通常可以由明白地給定的年、月、日數字來創建，或者使用靜態函數<a href="#currentDate">currentDate</a>()讓QDate對象包含系統時鐘日期。一個明確的日期也可以用<a href="#setYMD">setYMD</a>()來設置。<a href="#fromString">fromString</a>()函數通過一個給定的字符串和在字符串中日期格式的間隔說明就可以返回一個QDate。
<p> <a href="#year">year</a>()、<a href="#month">month</a>()和<a href="#day">day</a>()函數提供了對年、月、日數字的訪問。也提供了<a href="#dayOfWeek">dayOfWeek</a>()和<a href="#dayOfYear">dayOfYear</a>()函數。<a href="#toString">toString</a>()、<a href="#shortDayName">shortDayName</a>()、<a href="#longDayName">longDayName</a>()、<a href="#shortMonthName">shortMonthName</a>()和<a href="#longMonthName">longMonthName</a>()提供了文本格式的相同信息。
<p> QDate提供了一整套的操作符來比較兩個QDate對象，在這里小于表示早一些，大于表示晚一些。
<p> 你可以使用<a href="#addDays">addDays</a>()給一個日期增加（或減少）一個給定的天數。相似地你可以使用<a href="#addMonths">addMonths</a>()和<a href="#addYears">addYears</a>()。<a href="#daysTo">daysTo</a>()函數返回兩個日期之間的天數。
<p> <a href="#daysInMonth">daysInMonth</a>()和<a href="#daysInYear">daysInYear</a>()函數分別返回這個日期在當月和當年的天數。<a href="#leapYear">leapYear</a>()函數說明這個日期是不是在一個閏年中。
<p> 注意QDate不應用于早于格列高利歷的日期的計算。這個歷法是英格蘭從1752年9月14日采用的（因此這是最早有效的QDate），并且后來其他絕大多數西方國家知道1923年才采用。
<p> QDate的結束時間可以一直到8000年，到那個時候我們希望Qt已經被廢棄了。
<p> <p>也可以參考<a href="qtime.html">QTime</a>、<a href="qdatetime.html">QDateTime</a>、<a href="qdateedit.html">QDateEdit</a>、<a href="qdatetimeedit.html">QDateTimeEdit</a>和<a href="time.html">時間和日期</a>。
<hr><h2>成員函數文檔</h2>
<h3 class=fn><a name="QDate"></a>QDate::QDate ()
</h3>
構造一個零日期。零日期是無效的。
<p> <p>也可以參考<a href="#isNull">isNull</a>()和<a href="#isValid">isValid</a>()。
<h3 class=fn><a name="QDate-2"></a>QDate::QDate ( int y, int m, int d )
</h3>
構造一個年、月、日分別為<em>y</em>、<em>m</em>、<em>d</em>的日期。
<p> <em>y</em>必須在1752－8000之間，<em>m</em>必須在1－12之間，<em>d</em>必須在1－31之間。例外，如果<em>y</em>在0－99之間，它表示的是1900－1999。
<p> <p>也可以參考<a href="#isValid">isValid</a>()。
<h3 class=fn><a href="qdate.html">QDate</a> <a name="addDays"></a>QDate::addDays ( int ndays ) const
</h3>
返回這個日期對象<em>ndays</em>天之后的一個QDate對象（或者<em>ndays</em>天之前的，如果它是一個負數）。
<p> <p>也可以參考<a href="#daysTo">daysTo</a>()。
<h3 class=fn><a href="qdate.html">QDate</a> <a name="addMonths"></a>QDate::addMonths ( int nmonths ) const
</h3>
返回這個日期對象<em>nmonths</em>月之后的一個QDate對象（或者<em>nmonths</em>月之前的，如果它是一個負數）。
<h3 class=fn><a href="qdate.html">QDate</a> <a name="addYears"></a>QDate::addYears ( int nyears ) const
</h3>
返回這個日期對象<em>nyears</em>年之后的一個QDate對象（或者<em>nyears</em>年之前的，如果它是一個負數）。
<h3 class=fn><a href="qdate.html">QDate</a> <a name="currentDate"></a>QDate::currentDate ()<tt> [靜態]</tt>
</h3>
返回當前日期，來自于系統時鐘。
<p> <p>也可以參考<a href="qtime.html#currentTime">QTime::currentTime</a>()和<a href="qdatetime.html#currentDateTime">QDateTime::currentDateTime</a>()。
<p>實例：<a href="dclock-example.html#x898">dclock/dclock.cpp</a>。
<h3 class=fn>int <a name="day"></a>QDate::day () const
</h3>
返回這個日期在月中的天數（1－31）。
<p> <p>也可以參考<a href="#year">year</a>()、<a href="#month">month</a>()和<a href="#dayOfWeek">dayOfWeek</a>()。
<p>實例：<a href="dclock-example.html#x899">dclock/dclock.cpp</a>。
<h3 class=fn><a href="qstring.html">QString</a> <a name="dayName"></a>QDate::dayName ( int weekday )<tt> [靜態]</tt>
</h3>
<b>這個函數是廢棄的。</b>它的提供是為了保證就代碼能夠工作。我們強烈建議你在新代碼中不要使用它。
<p> 使用<a href="#shortDayName">shortDayName</a>()來替代它。
<h3 class=fn>int <a name="dayOfWeek"></a>QDate::dayOfWeek () const
</h3>
返回這個日期中在星期中的天數（星期一為1－星期日為7）。
<p> <p>也可以參考<a href="#day">day</a>()和<a href="#dayOfYear">dayOfYear</a>()。
<h3 class=fn>int <a name="dayOfYear"></a>QDate::dayOfYear () const
</h3>
返回這個日期中在年中的天數（1－365）。
<p> <p>也可以參考<a href="#day">day</a>()和<a href="#dayOfWeek">dayOfWeek</a>()。
<h3 class=fn>int <a name="daysInMonth"></a>QDate::daysInMonth () const
</h3>
返回這個日期中這個月的總天數（28－31）。
<p> <p>也可以參考<a href="#day">day</a>()和<a href="#daysInYear">daysInYear</a>()。
<h3 class=fn>int <a name="daysInYear"></a>QDate::daysInYear () const
</h3>
返回這個日期中這個年的總天數（365－366）。
<p> <p>也可以參考<a href="#day">day</a>()和<a href="#daysInMonth">daysInMonth</a>()。
<h3 class=fn>int <a name="daysTo"></a>QDate::daysTo ( const <a href="qdate.html">QDate</a> & d ) const
</h3>
返回從這個日期到<em>d</em>的天數（如果<em>d</em>早于這個日期，返回的為負數）。
<p> 實例：
<pre>
QDate d1( 1995, 5, 17 ); // 1995年5月17日
QDate d2( 1995, 5, 20 ); // 1995年5月20日
d1.<a href="#daysTo">daysTo</a>( d2 ); // 返回3
d2.<a href="#daysTo">daysTo</a>( d1 ); // 返回-3
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -