QTime Class Reference
[QtCore module]

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

Returns the time represented in the string as a QTime using the format given, or an invalid time if this is not possible.

Note that fromString() uses a "C" locale encoded string to convert milliseconds to a float value. If the default locale is not "C", this may result in two conversion attempts (if the conversion fails for the default locale). This should be considered an implementation detail.

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

Returns the QTime represented by the string, using the format given, or an invalid time if the string cannot be parsed.

These expressions may be used for the format:

All other input characters will be treated as text. Any sequence of characters that are enclosed in single quotes will also be treated as text and not be used as an expression.

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

If the format is not satisfied an invalid QTime is returned. Expressions that do not expect leading zeroes to be given (h, m, s and z) are greedy. This means that they will use two digits even if this puts them outside the range of accepted values and leaves too few digits for other sections. For example, the following string could have meant 00:07:10, but the m will grab two digits, resulting in an invalid time:

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

Any field that is not represented in the format will be set to zero. For example:

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

QDateTime::toString() QTime::toString()

See also QDateTime::fromString(), QDate::fromString(), and QDate::toString().

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

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