Home · All Classes · Modules  · QSS HELP  · QSS 案例 · VER007 HOME

QTime Class Reference
^{[QtCore module]}

该QTIME类提供时钟时间的功能。More...

Methods

• __init__ (self)
• __init__ (self, int h, int m, int second = 0, int msec = 0)
• __init__ (self, QTime)
• QTime addMSecs (self, int ms)
• QTime addSecs (self, int secs)
• int elapsed (self)
• int hour (self)
• bool isNull (self)
• bool isValid (self)
• int minute (self)
• int msec (self)
• int msecsTo (self, QTime)
• int restart (self)
• int second (self)
• int secsTo (self, QTime)
• bool setHMS (self, int h, int m, int s, int msec = 0)
• start (self)
• datetime.time toPyTime (self)
• QString toString (self, Qt.DateFormat format = Qt.TextDate)
• QString toString (self, QString format)

Static Methods

• QTime currentTime ()
• QTime fromString (QString string, Qt.DateFormat format = Qt.TextDate)
• QTime fromString (QString s, QString format)
• bool isValid (int h, int m, int s, int msec = 0)

Special Methods

• int __bool__ (self)
• bool __eq__ (self, QTime other)
• bool __ge__ (self, QTime other)
• bool __gt__ (self, QTime other)
• int __hash__ (self)
• bool __le__ (self, QTime other)
• bool __lt__ (self, QTime other)
• bool __ne__ (self, QTime other)
• str __repr__ (self)

Detailed Description

这个类可以醃制。

也可以使用一个Python的datetime对象，每当一个QTime预计。

该QTIME类提供时钟时间的功能。

一个QTIME对象包含一个时钟时间，即小时，分钟，秒和毫秒自午夜数。它可以从系统时钟读取当前时间，并测量经过的时间跨度。它提供的功能，用于比较时间和用于通过将一个数毫秒的操作时间。

QTIME使用24小时时钟格式，它具有AM / PM的概念。不像QDateTime， QTIME一无所知时区或日光节约时间（DST ） 。

一个QTIME对象通常是通过给小时，分钟，秒和毫秒数显式，或使用静态函数创建currentTime（ ） ，它会创建一个包含系统的本地时间QTIME对象。请注意，精度依赖于底层操作系统的准确性;不是所有的系统都提供1毫秒的精度。

该hour（ ）minute（ ）second（）和msec（ ）函数可以访问的时，分，秒和时间的毫秒数。相同的信息被提供以文本格式toString（）函数。

QTIME提供了一整套的运营商来比较两个QTIME对象。一时间被认为比另一个更小，如果它是早于其他。

的时间的秒或毫秒的给定数量超过一个给定的时间可以用找到的addSecs（）或addMSecs（）函数。与此相对应，几秒钟或两个时间之间的毫秒数可以使用被发现secsTo（）或msecsTo（ ） 。

QTIME可用于使用测量的经过时间跨度的start（ ）restart（）和elapsed（）函数。

Method Documentation

QTime.__init__ (self)

构造一个空的时间对象。空时间可QTime（0，0 ，0，0 ）（即，午夜）对象，不同的是isNull（ ）返回True，isValid（ ）返回False 。

See also isNull（）和isValid（ ） 。

QTime.__init__ (self, int h, int m, int second = 0, int msec = 0)

构造一个时间小时h，分m，秒s和毫秒ms。

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

See also isValid（ ） 。

QTime.__init__ (self, QTime)

QTime QTime.addMSecs (self, int ms)

返回QTime对象包含时间ms毫秒迟于该对象的时间（或更早版本，如果ms是负的） 。

需要注意的是，如果它通过午夜的时候会换行。看addSecs（ ）的一个例子。

See also addSecs（ ）msecsTo（）和QDateTime.addMSecs（ ） 。

QTime QTime.addSecs (self, int secs)

返回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

See also addMSecs（ ）secsTo（）和QDateTime.addSecs（ ） 。

QTime QTime.currentTime ()

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

请注意，精度依赖于底层操作系统的准确性;不是所有的系统都提供1毫秒的精度。

int QTime.elapsed (self)

返回自上一次已经过的毫秒数start（）或restart（ ）被调用。

请注意，计数器回到零24小时内的最后一次通话后，start（）或重启。

请注意，精度依赖于底层操作系统的准确性;不是所有的系统都提供1毫秒的精度。

Warning:如果系统的时钟设置已自最后一次修改start（）或restart（ ）被调用，结果是不确定的。日光节约时间开启或关闭可能发生这种情况。

See also start（）和restart（ ） 。

QTime QTime.fromString (QString string, Qt.DateFormat format = Qt.TextDate)

传回所代表的时间string作为QTime使用format给予，或无效的时间，如果这是不可能的。

需要注意的是fromString （ ）使用“ C”语言环境编码的字符串，以毫秒为单位转换为float值。如果默认locale是不是“ C” ，这可能会导致两个转换的尝试（如果转换失败的默认语言环境） 。这应该被视为一个实现细节。

QTime QTime.fromString (QString s, QString format)

返回QTime由表示string使用format给予，或者如果字符串不能解析一个无效的时间。

这些表达式可以用于格式：

所有其他输入的字符将被视为文本。括在单引号中的任何字符序列也将被视为文本，而不是作为一个表达式。

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

如果该格式不被满足的无效QTime返回。不指望前导零应给予（H ， M，S和z ）表达式是贪婪的。这意味着它们将使用两个数字，即使这使他们接受的值的范围外，叶太少位数为其他部分。例如，下面的字符串可能意味着0时07分10秒，但米将抓住两个数字，从而导致无效时间：

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

未在该格式表示的任何字段将被设置为零。例如：

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

QDateTime.toString（ ）QTime.toString（ ）

See also QDateTime.fromString（ ）QDate.fromString（）和QDate.toString（ ） 。

int QTime.hour (self)

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

See also minute（ ）second（）和msec（ ） 。

bool QTime.isNull (self)

返回True如果时间为null （即，QTime使用默认构造函数）构造分布，否则返回False 。一个空的时间也是无效的时间。

See also isValid（ ） 。

bool QTime.isValid (self)

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

See also isNull（ ） 。

bool QTime.isValid (int h, int m, int s, int msec = 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 (self)

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

See also hour（ ）second（）和msec（ ） 。

int QTime.msec (self)

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

See also hour（ ）minute（）和second（ ） 。

int QTime.msecsTo (self, QTime)

返回的毫秒数从这个时候t。如果t早于当前时间，返回的毫秒数是负的。

因为QTime测量时间在一天之内，并有86400秒，一天的结果总是之间-86400000和86400000毫秒。

See also secsTo（ ）addMSecs（）和QDateTime.msecsTo（ ） 。

int QTime.restart (self)

设置此时间为当前时间，并返回自上一次已经过的毫秒数start（ ）或重新启动（）被调用。

此功能保证是原子的，因此是非常方便的重复测量。通话start（ ） ，开始第一次测量，并重新启动（ ）为每个后来的测量。

请注意，计数器回到零24小时内的最后一次通话后，start（ ）或重新启动（ ） 。

Warning:如果系统的时钟设置已自最后一次修改start（ ）或重新启动（ ）被调用，结果是不确定的。日光节约时间开启或关闭可能发生这种情况。

See also start（ ）elapsed（）和currentTime（ ） 。

int QTime.second (self)

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

See also hour（ ）minute（）和msec（ ） 。

int QTime.secsTo (self, QTime)

返回的秒数从这个时候t。如果t早于当前时间，返回的秒数为负。

因为QTime测量时间在一天之内，并有一天86400秒，结果总是-86400和86400之间。

secsTo （）不考虑任何毫秒。

See also addSecs（）和QDateTime.secsTo（ ） 。

bool QTime.setHMS (self, int h, int m, int s, int msec = 0)

设置时间小时h，分m，秒s和毫秒ms。

h必须在范围0〜23，m和s必须在范围0 〜59，ms必须在范围0到999 。返回True如果设定的时间是有效的，否则返回False 。

See also isValid（ ） 。

QTime.start (self)

设置这个时间设置为当前时间。这是不切实际的时机：

 QTime t;
 t.start();
 some_lengthy_task();
 qDebug("Time elapsed: %d ms", t.elapsed());

See also restart（ ）elapsed（）和currentTime（ ） 。

datetime.time QTime.toPyTime (self)

QString QTime.toString (self, Qt.DateFormat format = Qt.TextDate)

返回时间为一个字符串。该format参数决定了结果字符串的格式。

这些表达式可用于：

所有其它输入的字符将被忽略。括在singlequotes任何字符序列将被视为文本，而不是被用作表达。连续两singlequotes （ “''” ）是由singlequote输出所取代。

例如格式字符串（假设QTime是14:13:09.042 ）

如果日期时间是无效的，空字符串将被返回。如果format是空的，默认的格式为“ HH ： MM：SS ”一词。

See also QDate.toString（）和QDateTime.toString（ ） 。

QString QTime.toString (self, QString format)

这是一个重载函数。

返回时间为一个字符串。毫秒不包括在内。该format参数确定字符串的格式。

If format is Qt.TextDate，字符串格式为HH ： MM：SS ;例如午夜在1秒将是“ 23:59:59 ” 。

If format is Qt.ISODate，字符串格式对应于ISO 8601扩展规格的日期，这也是HH的表示： MM：SS 。 （然而，与ISO 8601 ，日期1582年10月15日之前为Julian日期，而不是公历日期的处理方式。见Use of Gregorian and Julian Calendars。这可能会改变的Qt的未来版本。 ）

如果format is Qt.SystemLocaleShortDate or Qt.SystemLocaleLongDate，字符串格式取决于系统的区域设置。相同的调用QLocale.system（ ） 。的toString （时间，QLocale.ShortFormat）或QLocale.system（ ） 。的toString （时间，QLocale.LongFormat） 。

如果format is Qt.DefaultLocaleShortDate or Qt.DefaultLocaleLongDate，字符串格式依赖于默认应用程序的语言环境。这就是语言环境设置QLocale.setDefault（ ）或系统区域设置，如果没有默认区域设置已定。相同的调用QLocale （ ） 。的toString （时间，QLocale.ShortFormat）或QLocale （ ） 。的toString （时间，QLocale.LongFormat） 。

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

int QTime.__bool__ (self)

bool QTime.__eq__ (self, QTime other)

bool QTime.__ge__ (self, QTime other)

bool QTime.__gt__ (self, QTime other)

int QTime.__hash__ (self)

bool QTime.__le__ (self, QTime other)

bool QTime.__lt__ (self, QTime other)

bool QTime.__ne__ (self, QTime other)

str QTime.__repr__ (self)