| 主页 | 所有的类 | 主要的类 | 注释的类 | 分组的类 | 函数 | |
QTime类提供了时钟时间功能。 详情请见……
#include <qdatetime.h>
QTime对象包含时钟时间，比如从午夜开始的时、分、秒和毫秒数。它可以从系统时钟中读取当前的时间并且度量时间的跨度。它提供比较时间和操作时间的函数，比如加上一定的秒或毫秒。
QTime操作的是24小时时钟格式，它没有AM/PM概念。它操作的是本地时间，它不知道有关时区或白天时间的概念。
QTime对象通常可以由明白地给定的时、分、秒和毫秒数字来创建，或者使用静态函数currentTime()让QTime对象包含系统时钟时间。注意精确性取决于下面操作系统的精确性，不是所有的操作系统都有毫秒级精确度的。
hour()、minute()、second()和msec()函数提供了对时、分、秒和毫秒数字的访问。toString()提供了文本格式的相同信息。
QTime提供了一整套的操作符来比较两个QTime对象，在这里小于表示早一些，大于表示晚一些。
一个给定时间之后给定的秒或毫秒数的时间可以使用addSecs()或addMSecs()得到。相对地，两个时间的秒（或毫秒）数可以使用secsTo()或msecsTo()得到。
QTime可以使用start()、restart()和elapsed()函数度量流逝的时间。
构造一个时、分、秒和毫秒都是0的时间，比如，00:00:00.000（午夜）。这是一个有效的时间。
也可以参考isValid()。
h必须在0－23之间，m和s必须在0－59之间，ms必须在0－999之间。
也可以参考isValid()。
注意如果这个时间过了午夜，它将被转换。请参考addSecs()中的实例。
注意如果这个时间过了午夜，它将被转换。
实例：
QTime n( 14, 0, 0 ); // n == 14:00:00
QTime t;
t = n.addSecs( 70 ); // t == 14:01:10
t = n.addSecs( -70 ); // t == 13:58:50
t = n.addSecs( 10*60*60 + 5 ); // t == 00:00:05
t = n.addSecs( -15*60*60 ); // t == 23:00:00
也可以参考addMSecs()、secsTo()和QDateTime::addSecs()。
注意精确性取决于下面操作系统的精确性，不是所有的操作系统都有毫秒级精确度的。
实例：aclock/aclock.cpp、dclock/dclock.cpp、t12/cannon.cpp和tictac/tictac.cpp。
注意如果在最后一次调用start()或restart()后24小时，计数器转换为0。
注意精确性取决于下面操作系统的精确性，不是所有的操作系统都有毫秒级精确度的。
警告： 如果最后一次调用start()或restart()之后，系统时钟设置发生了改变，结果将是不确定的。
注意Qt::LocalDate在这里不能使用。
也可以参考isValid()。
也可以参考isNull()。
如果时间是有效的，返回真，否则返回假。
如果h在0－23之间、m和s在0－59之间、ms在0－999之间，时间是有效的。
实例：
QTime::isValid(21, 10, 30); // 返回真
QTime::isValid(22, 5, 62); // 返回假
实例：aclock/aclock.cpp和tictac/tictac.cpp。
因为QTime只能度量一天之内的时间，而且一天内只有86400000毫秒，所以结果就应该在-86400000毫秒和86400000毫秒之间。
也可以参考secsTo()。
如果这个时间不等于t，返回真，否则返回假。
如果这个时间早于t，返回真，否则返回假。
如果这个时间不晚于t，返回真，否则返回假。
如果这个时间等于t，返回真，否则返回假。
如果这个时间晚于t，返回真，否则返回假。
如果这个时间不早于t，返回真，否则返回假。
这个函数保证是原子的并且这样对于重复度量是非常方便的。调用start()开始第一次度量，然后调用restart()来做以后的每一次度量。
注意如果在最后一次调用start()或restart()后24小时，计数器转换为0。
警告： 如果最后一次调用start()或restart()之后，系统时钟设置发生了改变，结果将是不确定的。
也可以参考start()、elapsed()和currentTime()。
因为QTime只能度量一天之内的时间，而且一天内只有86400秒，所以结果就应该在-86400秒和86400秒之间。
也可以参考addSecs() and QDateTime::secsTo().
实例：t12/cannon.cpp。
h必须在0－23之间，m和s必须在0－59之间，ms必须在0－999之间。如果设置的时间有效，返回真，否则返回假。
也可以参考isValid()。
QTime t;
t.start(); // 开始计时
... // 一些任务
qDebug( "%d\n", t.elapsed() ); // 打印过去的毫秒数
也可以参考restart()、elapsed()和currentTime()。
这些是可能用到的表达式：
所有其他输入字符都将被忽略。
格式字符串实例（假设这个QTime为14:13:09.042）
也可以参考QDate::toString()和QTime::toString()。
返回一个字符串的时间。f参数决定了结果字符串的格式。
如果f是Qt::TextDate，字符串格式是HH:MM:SS，比日午夜前一秒是“23:59:59”。
如果f是Qt::ISODate，字符串格式遵循ISO 8601表示时间的说明，也就是HH:MM:SS。
如果f是Qt::LocalDate，字符串格式依赖于系统的本地设置。
也可以参考QDataStream操作符的格式。
也可以参考QDataStream操作符的格式。
这个文件是Qt工具包一部分。 版权所有 © 1995-2002 Trolltech。保留所有权利。
| Copyright © 2002 Trolltech | Trademarks | 译者:Cavendish | Qt 3.0.5版
|