QTime Class

Documentation sur les fonctions membres

[constexpr] QTime::QTime()

Crée un objet de temps nul. Pour un temps nul, la fonction isNull() renvoie true et la fonction isValid() renvoie false. Si vous avez besoin d'un temps égal à zéro, utilisez QTime(0, 0). Pour le début d'une journée, consultez la fonction QDate::startOfDay().

Voir également isNull() et isValid().

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

Construit une heure avec l'heure h, les minutes m, les secondes s et les millisecondes ms.

h doit être compris entre 0 et 23, m et s doivent être compris entre 0 et 59, et ms doit être compris entre 0 et 999.

Voir également isValid().

QTime QTime::addMSecs(int ms) const

Renvoie un objet ` QTime ` contenant une heure ` ms ` millisecondes après l'heure de cet objet (ou avant si ` ms ` est négatif).

Notez que l'heure remettra à zéro si elle dépasse minuit. Voir addSecs() pour un exemple.

Renvoie une heure nulle si cette heure n’est pas valide.

Voir également addSecs(), msecsTo() et QDateTime::addMSecs().

QTime QTime::addSecs(int s) const

Renvoie un objet ` QTime ` contenant une heure s, qui correspond à un moment situé secondes après l'heure de cet objet (ou avant, si la valeur de ` s ` est négative).

Notez que l'heure réinitialisera si elle dépasse minuit.

Renvoie une heure nulle si cette heure n'est pas valide.

Exemple :

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

Voir également addMSecs(), secsTo() et QDateTime::addSecs().

[static] QTime QTime::currentTime()

Renvoie l'heure actuelle telle qu'elle est indiquée par l'horloge système.

Notez que la précision dépend de celle du système d'exploitation sous-jacent ; tous les systèmes n'offrent pas une précision à la milliseconde près.

De plus, la fonction currentTime() n'augmente qu’au cours d’une même journée ; elle diminue de 24 heures à chaque passage à minuit ; par ailleurs, ses variations peuvent ne pas correspondre au temps écoulé en cas de changement d’heure lié à l’heure d’été.

Voir également QDateTime::currentDateTime() et QDateTime::currentDateTimeUtc().

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

Renvoie une nouvelle instance d’ QTime dont l’heure est définie sur le nombre d’ msecs écoulées depuis le début de la journée, c’est-à-dire depuis 00:00:00.

Si msecs se situe en dehors de la plage valide, une valeur QTime non valide sera renvoyée.

Voir également msecsSinceStartOfDay().

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

Renvoie l'QTime représentée par la chaîne « string », en utilisant le format « format » fourni, ou une heure non valide si la chaîne ne peut pas être analysée.

Ces expressions peuvent être utilisées pour le format :

Toute séquence de caractères non vide placée entre guillemets simples sera également traitée (une fois les guillemets supprimés) comme du texte et ne sera pas interprétée comme une expression. Deux guillemets simples consécutifs («''») sont interprétés comme un guillemet simple devant être trouvé dans l’entrée, plutôt que comme le début ou la fin d’une séquence littérale. Tous les autres caractères de l’entrée seront traités comme du texte littéral à rechercher dans la chaîne d’entrée. Par exemple :

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

Si le format n’est pas respecté, une erreur « QTime » est renvoyée.

Lorsque des champs numériques sont juxtaposés, sans séparateur pour interrompre les séquences de chiffres, une ambiguïté peut subsister quant à savoir si certains champs pouvant comporter un seul chiffre utilisent deux chiffres (car la valeur à représenter est supérieure à 9). Lorsque l’attribution de deux chiffres à un tel champ en laisserait trop peu pour les autres champs, et que la lecture à un seul chiffre est cohérente avec les autres champs, cette ambiguïté peut être résolue. Dans le cas contraire (lorsque plusieurs champs peuvent comporter un seul chiffre et qu’il resterait des chiffres disponibles si chacun n’en recevait qu’un), une résolution attribuant des chiffres supplémentaires aux champs précédents est préférable à une solution les attribuant aux champs suivants, à condition que les données restent cohérentes. Par exemple :

QTime time = QTime::fromString("00:710", "hh:ms"); // 7 mins, 10 secs after midnight

Tout champ non représenté dans le format sera défini sur zéro. Par exemple :

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

Voir également toString(), QDateTime::fromString(), QDate::fromString(), QLocale::toTime() et QLocale::toDateTime().

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

Cette fonction a été introduite dans Qt 6.0.

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

Cette fonction a été introduite dans Qt 6.0.

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

Cette fonction a été introduite dans Qt 6.0.

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

Renvoie l'heure représentée dans l'string sous la forme d'un objet ` QTime ` à l'aide de l'format fournie, ou une heure non valide si cela n'est pas possible.

Voir également toString() et QLocale::toTime().

int QTime::hour() const

Renvoie la partie « heure » (de 0 à 23) de l'heure.

Renvoie -1 si l'heure n'est pas valide.

Voir également minute(), second() et msec().

[constexpr] bool QTime::isNull() const

Renvoie « true » si l'heure est nulle (c'est-à-dire si l'objet ` QTime ` a été créé à l'aide du constructeur par défaut) ; sinon, renvoie « false ». Une heure nulle est également une heure non valide.

Voir également isValid().

bool QTime::isValid() const

Renvoie « true » si l'heure est valide ; sinon, renvoie « false ». Par exemple, l'heure 23:30:55.746 est valide, mais 24:12:30 ne l'est pas.

Voir également isNull().

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

Renvoie « true » si l'heure indiquée est valide ; sinon, renvoie « false ».

L'heure est valide si h est comprise entre 0 et 23, si m et s sont comprises entre 0 et 59, et si ms est comprise entre 0 et 999.

Exemple :

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

int QTime::minute() const

Renvoie la partie « minutes » (de 0 à 59) de l'heure.

Renvoie -1 si l'heure n'est pas valide.

Voir également hour(), second() et msec().

int QTime::msec() const

Renvoie la partie en millisecondes (de 0 à 999) de l'heure.

Renvoie -1 si l'heure n'est pas valide.

Voir aussi hour(), minute() et second().

[constexpr] int QTime::msecsSinceStartOfDay() const

Renvoie le nombre de millisecondes écoulées depuis le début de la journée, c'est-à-dire depuis 00:00:00.

Voir également fromMSecsSinceStartOfDay().

int QTime::msecsTo(QTime t) const

Renvoie le nombre de millisecondes entre l'heure actuelle et t. Si t est antérieure à l'heure actuelle, le nombre de millisecondes renvoyé est négatif.

Comme QTime mesure le temps en jours et qu’un jour compte 86 400 secondes, le résultat est toujours compris entre -86 400 000 et 86 400 000 ms.

Renvoie 0 si l’une ou l’autre des heures n’est pas valide.

Voir également secsTo(), addMSecs() et QDateTime::msecsTo().

int QTime::second() const

Renvoie la deuxième partie (de 0 à 59) de l'heure.

Renvoie -1 si l'heure n'est pas valide.

Voir également hour(), minute() et msec().

int QTime::secsTo(QTime t) const

Renvoie le nombre de secondes entre l'heure actuelle et t. Si t est antérieure à l'heure actuelle, le nombre de secondes renvoyé est négatif.

Comme QTime mesure le temps au sein d’une journée et qu’une journée compte 86 400 secondes, le résultat est toujours compris entre -86 400 et 86 400.

La fonction secsTo() ne tient pas compte des millisecondes.

Renvoie 0 si l’une des heures n’est pas valide.

Voir également addSecs() et QDateTime::secsTo().

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

Définit l'heure sur h, les minutes sur m, les secondes sur s et les millisecondes sur ms.

h doit être compris entre 0 et 23, m et s doivent être compris entre 0 et 59, et ms doit être compris entre 0 et 999. Renvoie true si l'heure définie est valide ; sinon, renvoie false.

Voir également isValid().

Renvoie une chaîne de caractères représentant l'heure.

Le paramètre « format » détermine le format de la chaîne de caractères résultante. Si l'heure n'est pas valide, une chaîne vide sera renvoyée.

Les expressions suivantes peuvent être utilisées :

Lorsque le fuseau horaire ne peut pas être déterminé ou qu’aucune représentation appropriée n’est disponible, les formes t permettant de le représenter peuvent être ignorées. Voir QTimeZone::displayName() pour plus de détails sur les cas où cette fonction renvoie une chaîne vide.

Toute séquence non vide de caractères placée entre guillemets simples sera incluse telle quelle dans la chaîne de sortie (sans les guillemets), même si elle contient des caractères de mise en forme. Deux guillemets simples consécutifs («''») sont remplacés par un seul guillemet simple dans la sortie, plutôt que de marquer le début ou la fin d’une séquence littérale. Tous les autres caractères de la chaîne de format sont inclus tels quels dans la chaîne de sortie.

Les formats sans séparateurs (par exemple « hhmm ») sont pris en charge mais doivent être utilisés avec précaution, car les chaînes résultantes ne sont pas toujours lisibles de manière fiable (par exemple, si « Hm » produit « 212 », cela pourrait signifier soit 02:12, soit 21:02).

Exemples de chaînes de format (en supposant que l’ QTime e soit 14:13:09.042)

Voir également fromString(), QDate::toString(), QDateTime::toString() et QLocale::toString().

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

Renvoie l'heure sous forme de chaîne de caractères. Le paramètre format détermine le format de cette chaîne.

Si format vaut Qt::TextDate, le format de la chaîne est HH:mm:ss ; par exemple, 1 seconde avant minuit s'affichera sous la forme « 23:59:59 ».

format Si format vaut Qt::ISODate, le format de la chaîne correspond à la spécification étendue ISO 8601 pour la représentation des dates, sous la forme HH:mm:ss. Pour inclure les millisecondes dans la date ISO 8601, utilisez l'Qt::ISODateWithMs , qui correspond à HH:mm:ss.zzz.

Si l'format est Qt::RFC2822Date, la chaîne est formatée selon la norme RFC 2822. Un exemple de ce formatage est « 23:59:20 ».

Si l'heure n'est pas valide, une chaîne vide sera renvoyée.

Voir également fromString(), QDate::toString(), QDateTime::toString() et QLocale::toString().