qdatetime.html

QT参考文档

<h3 class=fn>bool <a name="isNull"></a>QDateTime::isNull () const
</h3>
<p> 如果日期和时间都是零，返回真，否则返回假。一个零日期时间是无效的。
<p> <p>也可以参考<a href="qdate.html#isNull">QDate::isNull</a>()和<a href="qtime.html#isNull">QTime::isNull</a>()。

<h3 class=fn>bool <a name="isValid"></a>QDateTime::isValid () const
</h3>
<p> 如果日期和时间都是有效的，返回真，否则返回假。
<p> <p>也可以参考<a href="qdate.html#isValid">QDate::isValid</a>()和<a href="qtime.html#isValid">QTime::isValid</a>()。

<h3 class=fn>bool <a name="operator!-eq"></a>QDateTime::operator!= ( const&nbsp;<a href="qdatetime.html">QDateTime</a>&nbsp;&amp;&nbsp;dt ) const
</h3>
如果这个日期时间不等于<em>dt</em>，返回真，否则返回假。
<p> <p>也可以参考<a href="#operator-eq-eq">operator==</a>()。

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

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

<h3 class=fn>bool <a name="operator-eq-eq"></a>QDateTime::operator== ( const&nbsp;<a href="qdatetime.html">QDateTime</a>&nbsp;&amp;&nbsp;dt ) const
</h3>
如果这个日期时间等于<em>dt</em>，返回真，否则返回假。
<p> <p>也可以参考<a href="#operator!-eq">operator!=</a>()。

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

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

<h3 class=fn>int <a name="secsTo"></a>QDateTime::secsTo ( const&nbsp;<a href="qdatetime.html">QDateTime</a>&nbsp;&amp;&nbsp;dt ) const
</h3>
返回从这个日期到<em>dt</em>的秒数（如果<em>dt</em>早于这个日期，返回的为负数）。
<p> 实例：
<pre>
    QDateTime dt = QDateTime::<a href="#currentDateTime">currentDateTime</a>();
    QDateTime xmas( QDate(dt.year(),12,24), QTime(17,00) );
    <a href="qapplication.html#qDebug">qDebug</a>( "There are %d seconds to Christmas", dt.<a href="#secsTo">secsTo</a>(xmas) ); // 离圣诞节还有多少秒
  </pre>
 
<p> <p>也可以参考<a href="#addSecs">addSecs</a>()、<a href="#daysTo">daysTo</a>()和<a href="qtime.html#secsTo">QTime::secsTo</a>()。

<h3 class=fn>void <a name="setDate"></a>QDateTime::setDate ( const&nbsp;<a href="qdate.html">QDate</a>&nbsp;&amp;&nbsp;date )
</h3>
<p> 设置日期时间的日期部分为<em>date</em>。
<p> <p>也可以参考<a href="#date">date</a>()和<a href="#setTime">setTime</a>()。

<h3 class=fn>void <a name="setTime"></a>QDateTime::setTime ( const&nbsp;<a href="qtime.html">QTime</a>&nbsp;&amp;&nbsp;time )
</h3>
<p> 设置日期时间的时间部分为<em>time</em>。
<p> <p>也可以参考<a href="#time">time</a>()和<a href="#setDate">setDate</a>()。

<h3 class=fn>void <a name="setTime_t"></a>QDateTime::setTime_t ( uint&nbsp;secsSince1Jan1970UTC )
</h3>
通过给定的从1970年1月1日00:00:00（通用协调时间）所过的秒来设置本地时间的日期和时间。在不支持时区的系统上，这个函数的行为就好像本地时间是通用协调时间一样。
<p> 注意Microsoft Windows只支持一定范围的<em>secsSince1Jan1970UTC</em>的值。

<h3 class=fn><a href="qtime.html">QTime</a> <a name="time"></a>QDateTime::time () const
</h3>
<p> 返回日期时间的时间部分。
<p> <p>也可以参考<a href="#setTime">setTime</a>()和<a href="#date">date</a>()。

<h3 class=fn><a href="qstring.html">QString</a> <a name="toString"></a>QDateTime::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="qdate.html#shortDayName">QDate::shortDayName</a>()。
<li> <em>dddd</em> - 长的日名称（Monday－Sunday）。使用<a href="qdate.html#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="qdate.html#shortMonthName">QDate::shortMonthName</a>()。
<li> <em>MMMM</em> - 长的月名称（January－December）。使用<a href="qdate.html#longMonthName">QDate::longMonthName</a>()。
<li> <em>yy</em> - 两位数字的年（00－99）
<li> <em>yyyy</em> - 四位数字的年（0000-9999）
</ul>
<p> 这些是可能用到的时间表达式：
<p> <ul>
<li> <em>h</em> - 没有前置0的数字的小时（0－23或者如果显示AM/PM时，1－12）
<li> <em>hh</em> - 前置0的数字的小时（00－23或者如果显示AM/PM时，01－12）
<li> <em>m</em> - 没有前置0的数字的分钟（0－59）
<li> <em>mm</em> - 前置0的数字的分钟（00－59）
<li> <em>s</em> - 没有前置0的数字的秒（0－59）
<li> <em>ss</em> - 前置0的数字的秒（00－59）
<li> <em>z</em> - 没有前置0的数字的毫秒（0－999）
<li> <em>zzz</em> - 前置0的数字的毫秒（000－999）
<li> <em>AP</em> - 切换为AM/PM显示。<em>AP</em>将被“AM”或“PM”替换。
<li> <em>ap</em> - 切换为am/pm显示。<em>ap</em>将被“am”或“pm”替换。
</ul>
<p> 所有其他输入字符都将被忽略。
<p> 格式字符串实例（假设这个QDateTime为2001年5月21日14:13:09）
<p> <ul>
<li> “dd.MM.yyyy”的结果将是“21.05.2001”
<li> “ddd MMMM d yy”的结果将是“Tue May 21 01”
<li> “hh:mm:ss.zzz”的结果将是“14:13:09.042”
<li> “h:m:s ap”的结果将是“2:13:9 pm”
</ul>
<p> <p>也可以参考<a href="qdate.html#toString">QDate::toString</a>()和<a href="qtime.html#toString">QTime::toString</a>()。

<p> 
<h3 class=fn><a href="qstring.html">QString</a> <a name="toString-2"></a>QDateTime::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，字符串格式是“Wed May 20 03:40:13
1998”（使用<a href="qdate.html#shortDayName">shortDayName</a>()、<a href="qdate.html#shortMonthName">shortMonthName</a>()和<a href="qtime.html#toString">QTime::toString</a>()函数来生成本地指定的字符串）。
<p> 如果<em>f</em>是Qt::ISODate，字符串格式遵循ISO 8601表示日期和时间的说明，也就是YYYY-MM-DDTHH:MM:SS。
<p> 如果<em>f</em>是Qt::LocalDate，字符串格式依赖于系统的本地设置。
<p> 如果<em>f</em>是无效的，<a href="#toString">toString</a>()返回一个空字符串。
<p> <p>也可以参考<a href="qdate.html#toString">QDate::toString</a>()和<a href="qtime.html#toString">QTime::toString</a>()。

<p> 
<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="qdatetime.html">QDateTime</a>&nbsp;&amp;&nbsp;dt )
</h3>
写日期时间<em>dt</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="qdatetime.html">QDateTime</a>&nbsp;&amp;&nbsp;dt )
</h3>
从流<em>s</em>中读取一个日期时间到<em>dt</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>