QTime Class

成员函数文档

返回代表时间的字符串。

format 参数决定结果字符串的格式。如果时间无效，则返回空字符串。

可以使用这些表达式：

当无法确定时区或没有合适的时区表示法时，可以跳过t 表示法。关于何时返回空字符串，请参阅QTimeZone::displayName() 。

任何用单引号括起来的非空字符序列都将逐字包含在输出字符串中（去掉引号），即使其中包含格式化字符。在输出中，两个连续的单引号（"''"）会被一个单引号取代。格式字符串中的所有其他字符将逐字包含在输出字符串中。

支持不带分隔符的格式（如 "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 的范围内， 和 必须在 0 至 59 的范围内， 必须在 0 至 999 的范围内。m s ms

另请参阅 isValid() 。

QTime QTime::addMSecs(int ms) const

返回一个QTime 对象，其中包含一个比该对象的时间晚ms 毫秒的时间（如果ms 为负数，则返回更早的时间）。

需要注意的是，如果时间过了午夜，则会被换行。示例参见addSecs() 。

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

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

QTime QTime::addSecs(int s) const

返回一个QTime 对象，其中包含一个比该对象时间晚s 秒的时间（如果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)

使用给定的format 将string 中代表的时间返回为QTime ，如果无法返回，则返回无效时间。

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

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

使用给出的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

格式中未表示的任何字段都将设为零。例如

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

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

[static, since 6.0] QTime QTime::fromString(QStringView string, QStringView format)

这是一个重载函数。

该函数在 Qt 6.0 中引入。

[static, since 6.0] QTime QTime::fromString(QStringView string, Qt::DateFormat format = Qt::TextDate)

这是一个重载函数。

该函数在 Qt 6.0 中引入。

[static, since 6.0] QTime QTime::fromString(const QString &string, QStringView format)

这是一个重载函数。

该函数在 Qt 6.0 中引入。

int QTime::hour() const

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

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

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

[constexpr] bool QTime::isNull() const

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

另请参阅 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 测量的是一天内的时间，而一天有 86400 秒，因此结果总是介于 -86400000 和 86400000 毫秒之间。

如果时间无效，则返回 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 的范围内， 和 必须在 0 至 59 的范围内， 必须在 0 至 999 的范围内。如果设置的时间有效，则返回 ；否则返回 。m s ms 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。

如果format 是Qt::RFC2822Date ，字符串格式将与RFC 2822兼容。这种格式化的一个例子是 "23:59:20"。

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

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