📄 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 + -