qtime.html

QT软件的详细说明

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

<h3 class=fn>bool <a name="isValid"></a>QTime::isValid () const
</h3>
如果时间是有效的，返回真，否则返回假。时间23:30:55.746是有效的，而24:12:30是无效的。
<p> <p>也可以参考<a href="#isNull">isNull</a>()。

<h3 class=fn>bool <a name="isValid-2"></a>QTime::isValid ( int&nbsp;h, int&nbsp;m, int&nbsp;s, int&nbsp;ms = 0 )<tt> [静态]</tt>
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 如果时间是有效的，返回真，否则返回假。
<p> 如果<em>h</em>在0－23之间、<em>m</em>和<em>s</em>在0－59之间、<em>ms</em>在0－999之间，时间是有效的。
<p> 实例：
<pre>
    QTime::<a href="#isValid">isValid</a>(21, 10, 30); // 返回真
    QTime::<a href="#isValid">isValid</a>(22, 5,  62); // 返回假
  </pre>
 

<h3 class=fn>int <a name="minute"></a>QTime::minute () const
</h3>
返回时间的分钟部分（0－59）。
<p>实例：<a href="aclock-example.html#x1220">aclock/aclock.cpp</a>和<a href="tictac-example.html#x138">tictac/tictac.cpp</a>。

<h3 class=fn>int <a name="msec"></a>QTime::msec () const
</h3>
返回时间的毫秒部分（0－999）。

<h3 class=fn>int <a name="msecsTo"></a>QTime::msecsTo ( const&nbsp;<a href="qtime.html">QTime</a>&nbsp;&amp;&nbsp;t ) const
</h3>
返回这个时间到<em>t</em>的毫秒数（如果<em>t</em>早于这个时间，返回的为负数）。
<p> 因为QTime只能度量一天之内的时间，而且一天内只有86400000毫秒，所以结果就应该在-86400000毫秒和86400000毫秒之间。
<p> <p>也可以参考<a href="#secsTo">secsTo</a>()。

<h3 class=fn>bool <a name="operator!-eq"></a>QTime::operator!= ( const&nbsp;<a href="qtime.html">QTime</a>&nbsp;&amp;&nbsp;t ) const
</h3>
<p> 如果这个时间不等于<em>t</em>，返回真，否则返回假。

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

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

<h3 class=fn>bool <a name="operator-eq-eq"></a>QTime::operator== ( const&nbsp;<a href="qtime.html">QTime</a>&nbsp;&amp;&nbsp;t ) const
</h3>
<p> 如果这个时间等于<em>t</em>，返回真，否则返回假。

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

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

<h3 class=fn>int <a name="restart"></a>QTime::restart ()
</h3>
设置这个时间为当前时间并且返回从最后一次调用<a href="#start">start</a>()或<a href="#restart">restart</a>()到现在过去的毫秒数。
<p> 这个函数保证是原子的并且这样对于重复度量是非常方便的。调用start()开始第一次度量，然后调用restart()来做以后的每一次度量。
<p> 注意如果在最后一次调用start()或restart()后24小时，计数器转换为0。
<p> <b>警告：</b> 如果最后一次调用start()或restart()之后，系统时钟设置发生了改变，结果将是不确定的。
<p> <p>也可以参考<a href="#start">start</a>()、<a href="#elapsed">elapsed</a>()和<a href="#currentTime">currentTime</a>()。

<h3 class=fn>int <a name="second"></a>QTime::second () const
</h3>
返回时间的秒部分（0－59）。
<p>实例：<a href="tictac-example.html#x139">tictac/tictac.cpp</a>。

<h3 class=fn>int <a name="secsTo"></a>QTime::secsTo ( const&nbsp;<a href="qtime.html">QTime</a>&nbsp;&amp;&nbsp;t ) const
</h3>
返回这个时间到<em>t</em>的秒数（如果<em>t</em>早于这个时间，返回的为负数）。
<p> 因为QTime只能度量一天之内的时间，而且一天内只有86400秒，所以结果就应该在-86400秒和86400秒之间。
<p> <p>也可以参考<a href="#addSecs">addSecs</a>() and <a href="qdatetime.html#secsTo">QDateTime::secsTo</a>().
<p>实例：<a href="tutorial1-12.html#x2386">t12/cannon.cpp</a>。

<h3 class=fn>bool <a name="setHMS"></a>QTime::setHMS ( int&nbsp;h, int&nbsp;m, int&nbsp;s, int&nbsp;ms = 0 )
</h3>
设置时间的时、分、秒和毫秒分别为<em>h</em>、<em>m</em>、<em>s</em>和<em>ms</em>。
<p> <em>h</em>必须在0－23之间，<em>m</em>和<em>s</em>必须在0－59之间，<em>ms</em>必须在0－999之间。如果设置的时间有效，返回真，否则返回假。
<p> <p>也可以参考<a href="#isValid">isValid</a>()。

<h3 class=fn>void <a name="start"></a>QTime::start ()
</h3>
设置这个时间为当前时间。这是实际上使用来计时的：
<p> <pre>
    QTime t;
    t.<a href="#start">start</a>();                     // 开始计时
    ... // 一些任务
    <a href="qapplication.html#qDebug">qDebug</a>( "%d\n", t.<a href="#elapsed">elapsed</a>() ); // 打印过去的毫秒数
  </pre>
 
<p> <p>也可以参考<a href="#restart">restart</a>()、<a href="#elapsed">elapsed</a>()和<a href="#currentTime">currentTime</a>()。

<h3 class=fn><a href="qstring.html">QString</a> <a name="toString"></a>QTime::toString ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;format ) const
</h3>  
返回一个字符串的时间。<em>format</em>参数决定了结果字符串的格式。
<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> 格式字符串实例（假设这个QTime为14:13:09.042）
<p> <ul>
<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="#toString">QTime::toString</a>()。

<p> 
<h3 class=fn><a href="qstring.html">QString</a> <a name="toString-2"></a>QTime::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，字符串格式是HH:MM:SS，比日午夜前一秒是“23:59:59”。
<p> 如果<em>f</em>是Qt::ISODate，字符串格式遵循ISO 8601表示时间的说明，也就是HH:MM:SS。
<p> 如果<em>f</em>是Qt::LocalDate，字符串格式依赖于系统的本地设置。

<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="qtime.html">QTime</a>&nbsp;&amp;&nbsp;t )
</h3>
写时间<em>t</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="qtime.html">QTime</a>&nbsp;&amp;&nbsp;t )
</h3>
从流<em>s</em>中读取一个时间到<em>t</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>