qdate.html

QT软件的详细说明

  </pre>
 
<p> <p>也可以参考<a href="#addDays">addDays</a>()。

<h3 class=fn><a href="qdate.html">QDate</a> <a name="fromString"></a>QDate::fromString ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;s, <a href="qt.html#DateFormat-enum">Qt::DateFormat</a>&nbsp;f = Qt::TextDate )<tt> [静态]</tt>
</h3>
通过给定的字符串<em>s</em>，使用格式<em>f</em>，返回这个QDate，或者如果这是不可能的话返回一个无效的日期。
<p> 注意Qt::LocalDate在这里不能使用。
<p> 注意Qt::TextDate：它被推荐使用英语中的月的缩写格式（比如Jan）。本地的月名称也可以被使用，但这取决于用户的本地设置。

<h3 class=fn>bool <a name="isNull"></a>QDate::isNull () const
</h3>
<p> 如果这个日期是零日期，返回真，否则返回假。一个零日期是无效的。
<p> <p>也可以参考<a href="#isValid">isValid</a>()。

<h3 class=fn>bool <a name="isValid"></a>QDate::isValid () const
</h3>
如果这个日期是有效的，返回真，否则返回假。
<p> <p>也可以参考<a href="#isNull">isNull</a>()。

<h3 class=fn>bool <a name="isValid-2"></a>QDate::isValid ( int&nbsp;y, int&nbsp;m, int&nbsp;d )<tt> [静态]</tt>
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 如果一个给定的（年、月、日分别为<em>y</em>、<em>m</em>、<em>d</em>）日期是有效的，返回真。
<p> 实例：
<pre>
    QDate::<a href="#isValid">isValid</a>( 2002, 5, 17 );  // 真，2002年5月17日是有效的
    QDate::<a href="#isValid">isValid</a>( 2002, 2, 30 );  // 假，2月30日是不存在的
    QDate::<a href="#isValid">isValid</a>( 2004, 2, 29 );  // 真，2004年是闰年
    QDate::<a href="#isValid">isValid</a>( 1202, 6, 6 );   // 假，1202是在格列高利历之前的
  </pre>
 
<p> 注意如果<em>y</em>在0－99范围内表示1900－1999。
<p> <p>也可以参考<a href="#isNull">isNull</a>()和<a href="#setYMD">setYMD</a>()。

<h3 class=fn>bool <a name="leapYear"></a>QDate::leapYear ( int&nbsp;y )<tt> [静态]</tt>
</h3>
如果给定的年<em>y</em>是闰年，返回真。

<h3 class=fn><a href="qstring.html">QString</a> <a name="longDayName"></a>QDate::longDayName ( int&nbsp;weekday )<tt> [静态]</tt>
</h3>
返回这一日<em>weekday</em>在星期中的长名称。
<p> 1 = “Monday”、2 = “Tuesday”、……7 = “Sunday”
<p> 日名称将根据系统本地设置而改变。
<p> <p>也可以参考<a href="#toString">toString</a>()、<a href="#shortDayName">shortDayName</a>()、<a href="#shortMonthName">shortMonthName</a>()和<a href="#longMonthName">longMonthName</a>()。

<h3 class=fn><a href="qstring.html">QString</a> <a name="longMonthName"></a>QDate::longMonthName ( int&nbsp;month )<tt> [静态]</tt>
</h3>
返回这一月<em>month</em>的长名称。
<p> 1 = “January”、2 = “February”、……12 = “December”
<p> 月名称将根据系统本地设置而改变。
<p> <p>也可以参考<a href="#toString">toString</a>()、<a href="#shortMonthName">shortMonthName</a>()、<a href="#shortDayName">shortDayName</a>()和<a href="#longDayName">longDayName</a>()。

<h3 class=fn>int <a name="month"></a>QDate::month () const
</h3>
返回这个日期的月（一月为1－十二月为12）。
<p> <p>也可以参考<a href="#year">year</a>()和<a href="#day">day</a>()。
<p>实例：<a href="dclock-example.html#x900">dclock/dclock.cpp</a>。

<h3 class=fn><a href="qstring.html">QString</a> <a name="monthName"></a>QDate::monthName ( int&nbsp;month )<tt> [静态]</tt>
</h3>
<b>这个函数是废弃的。</b>它的提供是为了保证就代码能够工作。我们强烈建议你在新代码中不要使用它。
<p> 使用<a href="#shortMonthName">shortMonthName</a>()来替代它。

<h3 class=fn>bool <a name="operator!-eq"></a>QDate::operator!= ( const&nbsp;<a href="qdate.html">QDate</a>&nbsp;&amp;&nbsp;d ) const
</h3>
如果这个日期不等于<em>d</em>，返回真，否则返回假。

<h3 class=fn>bool <a name="operator-lt"></a>QDate::operator&lt; ( const&nbsp;<a href="qdate.html">QDate</a>&nbsp;&amp;&nbsp;d ) const
</h3>
如果这个日期早于<em>d</em>，返回真，否则返回假。

<h3 class=fn>bool <a name="operator-lt-eq"></a>QDate::operator&lt;= ( const&nbsp;<a href="qdate.html">QDate</a>&nbsp;&amp;&nbsp;d ) const
</h3>
如果这个日期不晚于<em>d</em>，返回真，否则返回假。

<h3 class=fn>bool <a name="operator-eq-eq"></a>QDate::operator== ( const&nbsp;<a href="qdate.html">QDate</a>&nbsp;&amp;&nbsp;d ) const
</h3>
如果这个日期等于<em>d</em>，返回真，否则返回假。

<h3 class=fn>bool <a name="operator-gt"></a>QDate::operator&gt; ( const&nbsp;<a href="qdate.html">QDate</a>&nbsp;&amp;&nbsp;d ) const
</h3>
如果这个日期晚于<em>d</em>，返回真，否则返回假。

<h3 class=fn>bool <a name="operator-gt-eq"></a>QDate::operator&gt;= ( const&nbsp;<a href="qdate.html">QDate</a>&nbsp;&amp;&nbsp;d ) const
</h3>
如果这个日期不早于<em>d</em>，返回真，否则返回假。

<h3 class=fn>bool <a name="setYMD"></a>QDate::setYMD ( int&nbsp;y, int&nbsp;m, int&nbsp;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> 如果日期有效，返回真，否则返回假。

<h3 class=fn><a href="qstring.html">QString</a> <a name="shortDayName"></a>QDate::shortDayName ( int&nbsp;weekday )<tt> [静态]</tt>
</h3>
返回这一日<em>weekday</em>在星期中的名称。
<p> 1 = “Mon”、2 = “Tue”、……7 = “Sun”
<p> 日名称将根据系统本地设置而改变。
<p> <p>也可以参考<a href="#toString">toString</a>()、<a href="#shortMonthName">shortMonthName</a>()、<a href="#longMonthName">longMonthName</a>()和<a href="#longDayName">longDayName</a>()。

<h3 class=fn><a href="qstring.html">QString</a> <a name="shortMonthName"></a>QDate::shortMonthName ( int&nbsp;month )<tt> [静态]</tt>
</h3>
返回这一月<em>month</em>的名称。
<p> 1 = “Jan”、2 = “Feb”、……12 = “Dec”
<p> 月名称将根据系统本地设置而改变。
<p> <p>也可以参考<a href="#toString">toString</a>()、<a href="#longMonthName">longMonthName</a>()、<a href="#shortDayName">shortDayName</a>()和<a href="#longDayName">longDayName</a>()。

<h3 class=fn><a href="qstring.html">QString</a> <a name="toString"></a>QDate::toString ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;format ) const
</h3>  
返回一个字符串的日期。<em>format</em>参数决定了结果字符串的格式。
<p> 这些是可能用到的表达式：
<p> <ul>
<li> <em>d</em> - 没有前置0的数字的天（1－31）
<li> <em>dd</em> - 前置0的数字的天（01－31）
<li> <em>ddd</em> - 缩写的日名称（Mon－Sun）。使用<a href="#shortDayName">QDate::shortDayName</a>()。
<li> <em>dddd</em> - 长的日名称（Monday－Sunday）。使用<a href="#longDayName">QDate::longDayName</a>()。
<li> <em>M</em> - 没有前置0的数字的月（1－12）
<li> <em>MM</em> - 前置0的数字的月（01－12）
<li> <em>MMM</em> - 缩写的月名称（Jan－Dec）。使用<a href="#shortMonthName">QDate::shortMonthName</a>()。
<li> <em>MMMM</em> - 长的月名称（January－December）。使用<a href="#longMonthName">QDate::longMonthName</a>()。
<li> <em>yy</em> - 两位数字的年（00－99）
<li> <em>yyyy</em> - 四位数字的年（0000-9999）
</ul>
<p> 所有其他输入字符都将被忽略。
<p> 格式字符串实例（假设这个QDate为2001年5月21日）
<p> <ul>
<li> “dd.MM.yyyy”的结果将是“21.05.2001”。
<li> “ddd MMMM d yy”的结果将是“Tue May 21 01”。
</ul>
<p> <p>也可以参考<a href="#toString">QDate::toString</a>() and <a href="qtime.html#toString">QTime::toString</a>().

<p> 
<h3 class=fn><a href="qstring.html">QString</a> <a name="toString-2"></a>QDate::toString ( <a href="qt.html#DateFormat-enum">Qt::DateFormat</a>&nbsp;f = Qt::TextDate ) const
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 返回一个字符串的日期。<em>f</em>参数决定了结果字符串的格式。
<p> 如果<em>f</em>是Qt::TextDate，字符串格式是“Sat May 20 1995”（使用<a href="#shortDayName">shortDayName</a>()和<a href="#shortMonthName">shortMonthName</a>()函数来生成本地指定的字符串）。
<p> 如果<em>f</em>是Qt::ISODate，字符串格式遵循ISO 8601表示日期的说明，也就是YYYY-MM-DD，YYYY是年，MM是月（01－12），DD是日（01－31）。
<p> 如果<em>f</em>是Qt::LocalDate，字符串格式依赖于系统的本地设置。
<p> <p>也可以参考<a href="#shortDayName">shortDayName</a>() and <a href="#shortMonthName">shortMonthName</a>().

<h3 class=fn>int <a name="year"></a>QDate::year () const
</h3>
返回这个日期的年（1752－8000）。
<p> <p>也可以参考<a href="#month">month</a>()和<a href="#day">day</a>()。

<hr><h2>相关函数</h2>
<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-lt-lt"></a>operator&lt;&lt; ( <a href="qdatastream.html">QDataStream</a>&nbsp;&amp;&nbsp;s, const&nbsp;<a href="qdate.html">QDate</a>&nbsp;&amp;&nbsp;d )
</h3>
写日期<em>d</em>到流<em>s</em>中。
<p> <p>也可以参考<a href="datastreamformat.html">QDataStream操作符的格式</a>。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-gt-gt"></a>operator&gt;&gt; ( <a href="qdatastream.html">QDataStream</a>&nbsp;&amp;&nbsp;s, <a href="qdate.html">QDate</a>&nbsp;&amp;&nbsp;d )
</h3>
从流<em>s</em>中读取一个日期到<em>d</em>中。
<p> <p>也可以参考<a href="datastreamformat.html">QDataStream操作符的格式</a>。

<!-- eof -->
<hr><p>
这个文件是<a href="index.html">Qt工具包</a>一部分。
版权所有 &copy; 1995-2002
<a href="http://www.trolltech.com/">Trolltech</a>。保留所有权利。
<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2002 
<a href="http://www.trolltech.com">Trolltech</a>
<td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td><a href="zh_CN.html">译者:Cavendish</a>
<td align=right><div align=right>Qt 3.0.5版</div>
</table></div></address></body>
</html>