QTime Class

Documentación de las funciones miembro

[constexpr] QTime::QTime()

Construye un objeto de tiempo nulo. Para una hora nula, isNull() devuelve true y isValid() devuelve false. Si necesitas una hora nula, utiliza QTime(0, 0). Para el inicio de un día, consulte QDate::startOfDay().

Véase también isNull() y isValid().

QTime::QTime(int h, int m, int s = 0, int ms = 0)

Construye una hora con hora h, minuto m, segundos s y milisegundos ms.

h debe estar en el rango de 0 a 23, m y s deben estar en el rango de 0 a 59, y ms debe estar en el rango de 0 a 999.

Véase también isValid().

QTime QTime::addMSecs(int ms) const

Devuelve un objeto QTime que contiene una hora ms milisegundos posterior a la hora de este objeto (o anterior si ms es negativo).

Tenga en cuenta que la hora se ajustará si pasa de medianoche. Véase addSecs() para un ejemplo.

Devuelve una hora nula si esta hora no es válida.

Véase también addSecs(), msecsTo() y QDateTime::addMSecs().

QTime QTime::addSecs(int s) const

Devuelve un objeto QTime que contiene una hora s segundos posterior a la hora de este objeto (o anterior si s es negativo).

Tenga en cuenta que la hora se ajustará si pasa de medianoche.

Devuelve una hora nula si esta hora no es válida.

Ejemplo:

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

Véase también addMSecs(), secsTo(), y QDateTime::addSecs().

[static] QTime QTime::currentTime()

Devuelve la hora actual indicada por el reloj del sistema.

Tenga en cuenta que la precisión depende de la precisión del sistema operativo subyacente; no todos los sistemas proporcionan una precisión de 1 milisegundo.

Además, currentTime() sólo aumenta dentro de cada día; descenderá 24 horas cada vez que pase la medianoche; y, aparte de esto, los cambios en ella pueden no corresponder al tiempo transcurrido, si interviene una transición de horario de verano.

Véase también QDateTime::currentDateTime() y QDateTime::currentDateTimeUtc().

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

Devuelve una nueva instancia de QTime con la hora ajustada al número de msecs desde el inicio del día, es decir, desde las 00:00:00.

Si msecs queda fuera del intervalo válido, se devolverá un QTime no válido.

Véase también msecsSinceStartOfDay().

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

Devuelve el QTime representado por el string, utilizando el format dado, o un tiempo inválido si la cadena no puede ser analizada.

Estas expresiones pueden utilizarse para el formato:

Todos los demás caracteres se tratarán como texto. Cualquier secuencia no vacía de caracteres entre comillas simples también se tratará (sin las comillas) como texto y no se interpretará como una expresión.

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

Si no se cumple el formato, se devuelve un QTime no válido. Las expresiones que no esperan ceros a la izquierda (h, m, s y z) son codiciosas. Esto significa que utilizarán dos dígitos (o tres, en el caso de z) aunque esto las sitúe fuera del rango de valores aceptados y deje muy pocos dígitos para otras secciones. Por ejemplo, la siguiente cadena podría haber significado 00:07:10, pero la m tomará dos dígitos, resultando en una hora inválida:

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

Cualquier campo que no esté representado en el formato se pondrá a cero. Por ejemplo:

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

Véase también toString(), QDateTime::fromString(), QDate::fromString(), QLocale::toTime() y QLocale::toDateTime().

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

Esta función se introdujo en Qt 6.0.

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

Esta función se introdujo en Qt 6.0.

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

Esta función se introdujo en Qt 6.0.

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

Devuelve la hora representada en string como QTime utilizando el format dado, o una hora inválida si esto no es posible.

Véase también toString() y QLocale::toTime().

int QTime::hour() const

Devuelve la parte de la hora (0 a 23) de la hora.

Devuelve -1 si la hora no es válida.

Véase también minute(), second() y msec().

[constexpr] bool QTime::isNull() const

Devuelve true si la hora es nula (es decir, el objeto QTime se construyó utilizando el constructor por defecto); en caso contrario devuelve false. Una hora nula es también una hora inválida.

Véase también isValid().

bool QTime::isValid() const

Devuelve true si la hora es válida; en caso contrario devuelve false. Por ejemplo, la hora 23:30:55.746 es válida, pero 24:12:30 es inválida.

Véase también isNull().

[static] bool QTime::isValid(int h, int m, int s, int ms = 0)

Devuelve true si la hora especificada es válida; en caso contrario devuelve false.

La hora es válida si h está en el rango de 0 a 23, m y s están en el rango de 0 a 59, y ms está en el rango de 0 a 999.

Ejemplo:

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

int QTime::minute() const

Devuelve la parte de los minutos (0 a 59) de la hora.

Devuelve -1 si la hora no es válida.

Véase también hour(), second() y msec().

int QTime::msec() const

Devuelve la parte en milisegundos (0 a 999) de la hora.

Devuelve -1 si la hora no es válida.

Véase también hour(), minute() y second().

[constexpr] int QTime::msecsSinceStartOfDay() const

Devuelve el número de mseg desde el inicio del día, es decir, desde las 00:00:00.

Véase también fromMSecsSinceStartOfDay().

int QTime::msecsTo(QTime t) const

Devuelve el número de milisegundos desde esta hora hasta t. Si t es anterior a esta hora, el número de milisegundos devuelto es negativo.

Como QTime mide el tiempo dentro de un día y hay 86400 segundos en un día, el resultado siempre está entre -86400000 y 86400000 ms.

Devuelve 0 si alguno de los tiempos no es válido.

Véase también secsTo(), addMSecs() y QDateTime::msecsTo().

int QTime::second() const

Devuelve la segunda parte (0 a 59) de la hora.

Devuelve -1 si la hora no es válida.

Véase también hour(), minute() y msec().

int QTime::secsTo(QTime t) const

Devuelve el número de segundos desde esta hora hasta t. Si t es anterior a esta hora, el número de segundos devuelto es negativo.

Como QTime mide el tiempo dentro de un día y hay 86400 segundos en un día, el resultado está siempre entre -86400 y 86400.

secsTo() no tiene en cuenta ningún milisegundo.

Devuelve 0 si alguna de las horas no es válida.

Véase también addSecs() y QDateTime::secsTo().

bool QTime::setHMS(int h, int m, int s, int ms = 0)

Establece la hora h, los minutos m, los segundos s y los milisegundos ms.

h debe estar en el rango de 0 a 23, m y s deben estar en el rango de 0 a 59, y ms debe estar en el rango de 0 a 999. Devuelve true si la hora establecida es válida; en caso contrario devuelve false.

Véase también isValid().

Devuelve una cadena que representa la hora.

El parámetro format determina el formato de la cadena resultante. Si la hora no es válida, se devolverá una cadena vacía.

Se pueden utilizar las siguientes expresiones:

Cuando no pueda determinarse la zona horaria o no se disponga de una representación adecuada de la misma, pueden omitirse los formatos t para representarla. Véase QTimeZone::displayName() para más detalles sobre cuándo devuelve una cadena vacía.

Cualquier secuencia de caracteres no vacía entre comillas simples se incluirá literalmente en la cadena de salida (sin las comillas), aunque contenga caracteres de formato. Dos comillas simples consecutivas ("''") se sustituyen por una comilla simple en la salida. Todos los demás caracteres de la cadena de formato se incluyen literalmente en la cadena de salida.

Los formatos sin separadores (por ejemplo, "hhmm") son compatibles, pero deben utilizarse con cuidado, ya que las cadenas resultantes no siempre son legibles de forma fiable (por ejemplo, si "Hm" produce "212", podría significar 02:12 o 21:02).

Ejemplo de cadenas de formato (suponiendo que QTime sea 14:13:09.042)

Véase también fromString(), QDate::toString(), QDateTime::toString() y QLocale::toString().

QString QTime::toString(Qt::DateFormat format = Qt::TextDate) const

Devuelve la hora en forma de cadena. El parámetro format determina el formato de la cadena.

Si format es Qt::TextDate, el formato de la cadena es HH:mm:ss; por ejemplo, 1 segundo antes de medianoche sería "23:59:59".

Si format es Qt::ISODate, el formato de la cadena corresponde a la especificación ampliada ISO 8601 para representaciones de fechas, representadas por HH:mm:ss. Para incluir milisegundos en la fecha ISO 8601, utilice format Qt::ISODateWithMs , que corresponde a HH:mm:ss.zzz.

Si format es Qt::RFC2822Date, la cadena se formatea de manera compatible con RFC 2822. Un ejemplo de este formato es "23:59:20".

Si la hora no es válida, se devolverá una cadena vacía.

Véase también fromString(), QDate::toString(), QDateTime::toString() y QLocale::toString().