Класс QTime

Класс QTime предоставляет функции работы со временем. Подробнее...

• Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются внутрипоточно-безопасными.

Открытые функции

Статические открытые члены

Связанные нечлены

Подробное описание

Класс QTime предоставляет функции работы со временем.

Объект QTime содержит время, которое он может представить как число часов, минут, секунд и миллисекунд с момента полуночи. Он может считывать текущее время с системных часов и измерять интервал времени. Он предоставляет функции для сравнения времен и для манипулирования временем, добавляя определенное количество миллисекунд.

Класс QTime использует формат 24-часовых часов; он не имеет понятия AM/PM. В отличие от QDateTime, QTime не знает ничего о часовых поясах или летнем времени.

Объект QTime обычно создается, либо указав количество часов, минут, секунд и миллисекунд явно, либо используя статическую функцию currentTime(), которая создает объект QTime, содержащий локальное время системы. Обратите внимание, что точность зависит от точности базовой операционной системы; не все системы обеспечивают точность до 1 миллисекунды.

Функции hour(), minute(), second() и msec() предоставляют доступ к количеству часов, минут, секунд и миллисекунд времени. Та же информация предоставляется в текстовом формате функцией toString().

Функции addSecs() и addMSecs() предоставляют время, которое на заданное количество секунд или миллисекунд позже, чем заданное время. Соответственно, количество секунд или миллисекунд между двумя моментами времени можно найти с помощью secsTo() или msecsTo().

Класс QTime предоставляет полный набор операторов для сравнения двух объектов QTime; более раннее время считается меньше, чем более позднее; если A.msecsTo(B) положительно, то A < B.

Класс QTime может использоваться для измерения интервала времени с помощью функций start(), restart() и elapsed().

См. также QDate и QDateTime.

Документация по функциям-членам

Возвращает время в виде строки. Параметр format определяет формат результирующей строки.

Можно использовать следующие выражения:

Любая последовательность символов, заключенная в одинарные кавычки, будет включена в строку вывода дословно (без кавычек), даже если она содержит символы форматирования. Два последовательных одинарных кавычки («''») заменяются одной кавычкой в выводе. Все остальные символы в строке формата включаются в строку вывода дословно.

Форматы без разделителей (например, «ddMM») поддерживаются, но должны использоваться с осторожностью, так как результирующие строки не всегда надежно читаемы (например, если «dM» дает «212», это может означать либо 2 декабря, либо 21 февраля).

Примеры строк формата (предполагается, что QTime составляет 14:13:09.042, а системный язык — en_US)

Если время недействительно, возвращается пустая строка. Если format пуста, используется формат по умолчанию «hh:mm:ss».

См. такжеfromString(), QDate::toString(), QDateTime::toString() и QLocale::toString().

QTime::QTime()

Создает объект времени «null». Объект «null» времени может быть объектом QTime(0, 0, 0, 0) (т. е. полночь), за исключением того, что isNull() возвращает true, а isValid() возвращает false.

См. также 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 миллисекунд позже или раньше времени этого объекта (если ms отрицательное).

Обратите внимание, что время «перемотается», если оно превысит полночь. См. addSecs() для примера.

Возвращает «null» время, если это время недействительно.

См. также addSecs(), msecsTo() и QDateTime::addMSecs().

QTime QTime::addSecs(int s) const

Возвращает объект QTime, содержащий время, на s секунд позже или раньше времени этого объекта (если s отрицательное).

Обратите внимание, что время «перемотается», если оно превысит полночь.

Возвращает «null» время, если это время недействительно.

Пример:

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 миллисекунды.

int QTime::elapsed() const

Возвращает количество миллисекунд, прошедших с момента последнего вызова start() или restart().

Обратите внимание, что счётчик сбрасывается до нуля через 24 часа после последнего вызова start() или restart.

Обратите внимание, что точность зависит от точности базовой операционной системы; не все системы обеспечивают точность до 1 миллисекунды.

Предупреждение: Если настройки системных часов были изменены с момента последнего вызова start() или restart(), результат не определён. Это может произойти при включении или выключении летнего времени.

См. также start() и restart().

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

Возвращает новый экземпляр QTime с временем, установленным на количество msecs миллисекунд с начала дня, т. е. с 00:00:00.

Если msecs выходит за пределы допустимого диапазона, возвращается недействительный QTime.

См. также msecsSinceStartOfDay().

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

Возвращает время, представленное в строке string как QTime с использованием заданного format, или недействительное время, если это невозможно.

Обратите внимание, что fromString() использует строку, закодированную в формате «C», для преобразования миллисекунд в число с плавающей точкой. Если локаль по умолчанию не «C», это может привести к двум попыткам преобразования (если преобразование завершается ошибкой для локале по умолчанию). Это следует рассматривать как реализационную деталь.

См. также toString() и QLocale::toTime().

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

Возвращает QTime, представленный строкой string с использованием заданного format, или недействительное время, если строка не может быть проанализирована.

Эти выражения могут использоваться для формата:

Все остальные символы входных данных будут обрабатываться как текст. Любая последовательность символов, заключенная в одинарные кавычки, также будет обрабатываться как текст и не будет использоваться как выражение.

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

Если формат не удовлетворяется, возвращается недействительный QTime. Выражения, не ожидающие ведущих нулей (h, m, s и 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().

int QTime::hour() const

Возвращает часть часа (0 до 23) времени.

Возвращает -1, если время недействительно.

См. также minute(), second() и msec().

bool QTime::isNull() const

Возвращает true, если время равно null (т.е., объект QTime был создан с использованием конструктора по умолчанию); в противном случае возвращает 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().

int QTime::msecsSinceStartOfDay() const

Возвращает количество миллисекунд с начала дня, т.е. с 00:00:00.

См. также fromMSecsSinceStartOfDay().

int QTime::msecsTo(const QTime &t) const

Возвращает количество миллисекунд от текущего времени до t. Если t раньше текущего времени, возвращается отрицательное значение.

Так как QTime измеряет время в пределах суток, а в сутках 86400 секунд, результат всегда находится в диапазоне от -86400000 до 86400000 мс.

Возвращает 0, если оба времени некорректны.

См. также secsTo(), addMSecs() и QDateTime::msecsTo().

int QTime::restart()

Устанавливает текущее время и возвращает количество миллисекунд, прошедших с момента последнего вызова start() или restart().

Этот метод гарантированно атомарный и очень удобен для многократных измерений. Вызовите start() для начала первого измерения и restart() для последующих.

Обратите внимание, что счётчик обнуляется через 24 часа после последнего вызова start() или restart().

Предупреждение: Если системные настройки времени были изменены с момента последнего вызова start() или restart(), результат не определён. Это может произойти при включении или выключении летнего времени.

См. также start(), elapsed() и currentTime().

int QTime::second() const

Возвращает секундную часть (0—59) времени.

Возвращает -1, если время некорректно.

См. также hour(), minute() и msec().

int QTime::secsTo(const 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().

void QTime::start()

Устанавливает текущее время. Это удобно для измерения времени:

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

См. также restart(), elapsed() и currentTime().

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::SystemLocaleShortDate или Qt::SystemLocaleLongDate, формат строки зависит от системных настроек локали. Идентично вызову QLocale::system().toString(time, QLocale::ShortFormat) или QLocale::system().toString(time, QLocale::LongFormat).

Если format равен Qt::DefaultLocaleShortDate или Qt::DefaultLocaleLongDate, формат строки зависит от локали приложения по умолчанию. Это локаль, установленная с помощью QLocale::setDefault(), или системная локаль, если локаль по умолчанию не установлена. Идентично вызову

QLocale().toString(time, QLocale::ShortFormat) или QLocale().toString(time, QLocale::LongFormat).

Если format равен Qt::RFC2822Date, строка форматируется в соответствии с RFC 2822. Пример такого форматирования: "23:59:20".

Если время некорректно, возвращается пустая строка.

См. также fromString(), QDate::toString(), QDateTime::toString() и QLocale::toString().

bool QTime::operator!=(const QTime &t) const

Возвращает true, если текущее время отличается от t; в противном случае возвращает false.

bool QTime::operator<(const QTime &t) const

Возвращает true, если текущее время раньше t; в противном случае возвращает false.

bool QTime::operator<=(const QTime &t) const

Возвращает true, если текущее время раньше или равно t; в противном случае возвращает false.

bool QTime::operator==(const QTime &t) const

Возвращает true, если текущее время равно t; в противном случае возвращает false.

bool QTime::operator>(const QTime &t) const

Возвращает true, если текущее время позже t; в противном случае возвращает false.

bool QTime::operator>=(const QTime &t) const

Возвращает true, если текущее время позже или равно t; в противном случае возвращает false.