Класс QTime

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

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

Примечание: Все функции в этом классе являются повторно входящими.

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

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

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

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

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

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

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

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

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

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

Объекты QTime также могут быть созданы из текстового представления с помощью fromString() и преобразованы в строковое представление с помощью toString(). Все преобразования в строковые форматы и из них выполняются с использованием локальной настройки C. Для локализованных преобразований см. QLocale.

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

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

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

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

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

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

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

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

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

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()

Создаёт объект времени null. Для объекта null isNull() возвращает true, а isValid() — false. Если вам нужно нулевое время, используйте QTime(0, 0). Для начала дня используйте QDate::startOfDay().

См. также isNull() и 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 миллисекунды.

Кроме того, currentTime() увеличивается только в течение каждого дня; оно уменьшается на 24 часа каждый раз, когда проходит полночь; и, помимо этого, изменения в нём могут не соответствовать прошедшему времени, если происходит переход на летнее время.

См. также QDateTime::currentDateTime() и QDateTime::currentDateTimeUtc().

[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 или недействительное время, если это невозможно.

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

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

Это перегруженный метод.

Этот метод был представлен в Qt 6.0.

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

Это перегруженный метод.

Этот метод был представлен в Qt 6.0.

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

Это перегруженный метод.

Этот метод был представлен в Qt 6.0.

[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), жадные. Это означает, что они будут использовать две цифры (или три для 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(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, 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; например, за секунду до полуночи будет "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().