QTime 类

成员函数文档

返回时间作为字符串。参数format确定结果字符串的格式。

可以使用以下表达式

单引号括起来的任何非空字符序列都将被逐字包含在输出字符串中（去除引号），即使它包含格式化字符。连续的两个单引号("''")在输出中将替换为一个单引号。格式字符串中的所有其他字符都将逐字包含在输出字符串中。

无分隔符的格式支持（例如"ddMM"），但必须小心使用，因为生成的字符串并不总是可靠的可读（例如，如果"dM"产生"212"，这可能意味着12月2日或2月21日）。

示例格式字符串（假设QTime为14:13:09.042）

如果时间无效，将返回空字符串。

另请参阅 fromString，QDate::toString，QDateTime::toString，和QLocale::toString。

[constexpr] QTime::QTime()

构造一个空时间对象。对于空时间，isNull() 返回 true，而 isValid() 返回 false。如果需要零时间，请使用 QTime(0, 0)。关于一天的开始，请参见 QDate::startOfDay。

另请参阅isNull() 和 isValid。

QTime::QTime(int h, int m, int s = 0, int ms = 0)

构造一个具有小时 h、分钟 m、秒数 s 和毫秒数 ms 的时间。

h 必须在 0 到 23 的范围内，m 和 s 必须在 0 到 59 的范围内，ms 必须在 0 到 999 的范围内。

另请参阅isValid。

QTime QTime::addMSecs(int ms) const

返回一个 QTime 对象，该对象的时间比该对象的时间晚 ms 毫秒（如果是负数，则表示较早）。

请注意，如果时间超过了午夜，时间会回绕。有关示例，请参见 addSecs。

如果此时间是无效的，则返回空时间。

另请参阅addSecs、msecsTo 和 QDateTime::addMSecs。

QTime QTime::addSecs(int s) const

返回一个 QTime 对象，该对象的时间比该对象的时间晚 s 秒（如果是负数，则表示较早）。

请注意，如果时间超过了午夜，时间会回绕。

如果此时间是无效的，则返回空时间。

示例

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。

[static] QTime QTime::currentTime()

返回系统时钟报告的当前时间。

注意，精度取决于底层操作系统的精度；并非所有系统都提供 1 毫秒的精度。

此外，currentTime() 在每天之内只增加；每当午夜通过时，它将下降 24 小时；如果发生夏令时转换，除此之外，它的变化可能不会对应于经过的时间。

另请参阅QDateTime::currentDateTime 和 QDateTime::currentDateTimeUtc。

[static constexpr] QTime QTime::fromMSecsSinceStartOfDay(int msecs)

返回一个新 QTime 实例，该实例的时间设置为从当天开始（即 00:00:00）以来的 msecs。

如果 msecs 落在有效范围之外，将返回一个无效的 QTime。

另请参阅msecsSinceStartOfDay。

[static] QTime QTime::fromString(const QString &string, Qt::DateFormat format = Qt::TextDate)

根据给定的格式将表示时间的字符串转换为 QTime，如果不可能，则返回一个无效的时间。

另请参阅 toString() 和 QLocale::toTime 函数。

[静态，自6.0以来] QTime QTime::fromString(QStringView string, Qt::DateFormat format = Qt::TextDate)

这是一个重载函数。

此函数在 Qt 6.0 中引入。

[静态，自6.0以来] QTime QTime::fromString(QStringView string, QStringView format)

这是一个重载函数。

此函数在 Qt 6.0 中引入。

[静态，自6.0以来] QTime QTime::fromString(const QString &string, QStringView format)

这是一个重载函数。

此函数在 Qt 6.0 中引入。

[静态] QTime QTime::fromString(const QString &string, const QString &format)

使用给定的格式将 string 转换为 QTime，如果字符串无法解析，则返回无效的时间。

以下表达式可用于格式

所有其他输入字符都将被视为文本。任何用单引号包围的非空字符序列也将视为文本（去除引号）而不是表达式。

QTime time = QTime::fromString("1mm12car00", "m'mm'hcarss");
// time is 12:01.00

如果格式不符合要求，则返回一个无效的 QTime。不期望给出前导零的表达式（h、m、s和z）是贪婪的。这意味着即使这使它们超出接受的值范围并留下太多的数字供其他部分使用，它们也会使用两位数（或者z为三位数）。例如，以下字符串可以意味着00:07:10，但m会抓取两个数字，结果是一个无效的时间

QTime time = QTime::fromString("00:710", "hh:ms"); // invalid

没有在格式中表示的字段将设置为0。例如

QTime time = QTime::fromString("1.30", "m.s");
// time is 00:01:30.000

另请参阅 toString()、QDateTime::fromString()、QDate::fromString()、QLocale::toTime() 和 QLocale::toDateTime。

int QTime::hour() const

返回时间的时部分（0到23）。

如果时间是无效的，则返回-1。

另请参阅 minute()、second() 和 msec。

[constexpr] bool QTime::isNull() const

如果时间是null（即，QTime对象使用默认构造函数构造），则返回true；否则返回false。无效的时间也是null时间。

另请参阅isValid。

bool QTime::isValid() const

如果时间是有效的，则返回true；否则返回false。例如，时间23:30:55.746是有效的，但24:12:30是无效的。

另请参阅 isNull。

[static] bool QTime::isValid(int h, int m, int s, int ms = 0)

这是一个重载函数。

如果指定的时间是有效的，则返回true；否则返回false。

时间有效当h在0到23的范围内，m和s在0到59的范围内，ms在0到999的范围内。

示例

QTime::isValid(21, 10, 30); // returns true
QTime::isValid(22, 5,  62); // returns false

int QTime::minute() const

返回时间的分钟部分（0到59）。

如果时间是无效的，则返回-1。

另请参阅 hour()、second() 和 msec。

int QTime::msec() const

返回时间的毫秒部分（0到999）。

如果时间是无效的，则返回-1。

另请参阅 hour()、minute() 和 second。

[constexpr] int QTime::msecsSinceStartOfDay() const

返回自一天开始以来的毫秒数，即自00:00:00以来。

另请参阅 fromMSecsSinceStartOfDay。

int QTime::msecsTo(QTime t) const

返回从该时间到t的毫秒数。如果t早于这个时间，则返回的毫秒数是负数。

因为QTime在一天内测量时间，一天中有86,400秒，所以结果总是在-86,400,000和86,400,000毫秒之间。

如果任一时间无效则返回0。

另请参阅: secsTo()、addMSecs()以及QDateTime::msecsTo()。

int QTime::second() const

返回时间的第二部分（0到59）。

如果时间是无效的，则返回-1。

另请参阅: hour()、minute()以及msec()。

int QTime::secsTo(QTime t) const

返回从当前时间到时间t的秒数。如果时间t早于当前时间，则返回的秒数是负数。

由于QTime在一天内测量时间，每天有86400秒，因此结果总是在-86400到86400之间。

secsTo()不考虑任何毫秒数。

如果任一时间无效则返回0。

另请参阅: addSecs()和QDateTime::secsTo()。

bool QTime::setHMS(int h, int m, int s, int ms = 0)

将时间设置为零h小时、零m分钟、零s秒和零ms毫秒。

h必须在0到23之间，m和s必须在0到59之间，而ms必须在0到999之间。如果设置的时间有效则返回true，否则返回false。

另请参阅isValid。

QString QTime::toString(Qt::DateFormat format = Qt::TextDate) const

这是一个重载函数。

以字符串形式返回时间。参数format决定字符串的格式。

如果format是Qt::TextDate，字符串格式为HH:mm:ss；例如，午夜前1秒将是"23:59:59"。

如果format是Qt::ISODate，字符串格式对应ISO 8601扩展规范中表示日期的方式，表示为HH:mm:ss。要包括ISO 8601日期中的毫秒，请使用格式format Qt::ISODateWithMs，对应HH:mm:ss.zzz。

如果格式是Qt::RFC2822Date，字符串将以RFC 2822兼容的方式进行格式化。这种格式的示例是"23:59:20"。

如果时间无效，将返回空字符串。

另请参阅 fromString，QDate::toString，QDateTime::toString，和QLocale::toString。