QTime Class

Documentation des fonctions membres

[constexpr] QTime::QTime()

Construit un objet de temps nul. Pour un temps nul, isNull() renvoie true et isValid() renvoie false. Si vous avez besoin d'une heure nulle, utilisez QTime(0, 0). Pour le début d'une journée, voir 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, la minute m, la seconde s et la milliseconde 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 l'heure ms en millisecondes plus tard que l'heure de cet objet (ou plus tôt si ms est négatif).

Notez que l'heure s'arrêtera si elle dépasse minuit. Voir addSecs() pour un exemple.

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

Voir aussi addSecs(), msecsTo(), et QDateTime::addMSecs().

QTime QTime::addSecs(int s) const

Renvoie un objet QTime contenant un temps s secondes plus tard que le temps de cet objet (ou plus tôt si s est négatif).

Notez que l'heure s'arrêtera 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 aussi addMSecs(), secsTo() et QDateTime::addSecs().

[static] QTime QTime::currentTime()

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

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

En outre, currentTime() n'augmente que chaque jour ; il diminue de 24 heures à chaque fois que minuit passe ; et, en outre, les changements qu'il subit peuvent ne pas correspondre au temps écoulé, si une transition vers l'heure d'été intervient.

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

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

Renvoie une nouvelle instance de QTime dont l'heure correspond au nombre de msecs depuis le début de la journée, c'est-à-dire depuis 00:00:00.

Si msecs est en dehors de la plage valide, une instance QTime invalide sera renvoyée.

Voir aussi msecsSinceStartOfDay().

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

Renvoie l'adresse QTime représentée par l'adresse string, en utilisant l'adresse format donnée, ou une heure invalide si la chaîne ne peut pas être analysée.

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

Tous les autres caractères d'entrée seront traités comme du texte. Toute séquence non vide de caractères entre guillemets simples sera également traitée (sans les guillemets) comme du texte et ne sera pas interprétée comme une expression.

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

Si le format n'est pas respecté, une adresse QTime invalide est renvoyée. Les expressions qui n'attendent pas de zéros en tête (h, m, s et z) sont gourmandes. Cela signifie qu'elles utiliseront deux chiffres (ou trois, pour z) même si cela les place en dehors de la plage des valeurs acceptées et laisse trop peu de chiffres pour d'autres sections. Par exemple, la chaîne suivante aurait pu signifier 00:07:10, mais le m prend deux chiffres, ce qui donne une heure invalide :

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

Tout champ qui n'est pas représenté dans le format sera mis à zéro. Par exemple, les champs qui ne sont pas représentés dans le format seront mis à zéro :

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 string sous forme de QTime en utilisant le format donné, ou une heure invalide si cela n'est pas possible.

Voir aussi toString() et QLocale::toTime().

int QTime::hour() const

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

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

Voir aussi 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é construit à l'aide du constructeur par défaut) ; sinon, renvoie false. Une heure nulle est également une heure invalide.

Voir aussi 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 aussi isNull().

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

Renvoie true si l'heure spécifiée est valide, sinon renvoie false.

L'heure est valide si h est compris entre 0 et 23, si m et s sont compris entre 0 et 59 et si ms est compris 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 minute (0 à 59) de l'heure.

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

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

int QTime::msec() const

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

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

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

[constexpr] int QTime::msecsSinceStartOfDay() const

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

Voir aussi fromMSecsSinceStartOfDay().

int QTime::msecsTo(QTime t) const

Renvoie le nombre de millisecondes entre cette heure et t. Si t est antérieur à cette heure, le nombre de millisecondes renvoyé est négatif.

Comme QTime mesure le temps à l'intérieur d'une journée et qu'il y a 86400 secondes dans une journée, le résultat est toujours compris entre -86400000 et 86400000 ms.

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

Voir aussi secsTo(), addMSecs() et QDateTime::msecsTo().

int QTime::second() const

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

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

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

int QTime::secsTo(QTime t) const

Renvoie le nombre de secondes entre cette heure et t. Si t est antérieur à cette heure, le nombre de secondes renvoyé est négatif.

Comme QTime mesure le temps à l'intérieur d'une journée et qu'il y a 86400 secondes dans une journée, le résultat est toujours compris entre -86400 et 86400.

secsTo() ne prend pas en compte les millisecondes.

Retourne 0 si l'une ou l'autre des heures n'est pas valide.

Voir aussi addSecs() et QDateTime::secsTo().

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

Définit l'heure en heures h, minutes m, secondes s et 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. Renvoie true si l'heure définie est valide ; sinon, renvoie false.

Voir aussi 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 résultat. 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 formulaires t pour le représenter peuvent être ignorés. Voir QTimeZone::displayName() pour plus de détails sur les cas où il renvoie une chaîne vide.

Toute séquence non vide de caractères entre guillemets simples sera incluse mot pour mot dans la chaîne de sortie (sans les guillemets), même si elle contient des caractères de formatage. Deux guillemets simples consécutifs ("'''") sont remplacés par un guillemet simple dans la sortie. 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éparateur (par exemple "hhmm") sont supportés 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 peut signifier soit 02:12, soit 21:02).

Exemples de chaînes de format (en supposant que le site QTime soit 14:13:09.042)

Voir aussi 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 la chaîne.

Si format est Qt::TextDate, le format de la chaîne est HH:mm:ss ; par exemple, 1 seconde avant minuit serait "23:59:59".

Si format est Qt::ISODate, le format de la chaîne correspond à la spécification étendue de l'ISO 8601 pour les représentations de dates, représentées par HH:mm:ss. Pour inclure les millisecondes dans la date ISO 8601, utilisez format Qt::ISODateWithMs , qui correspond à HH:mm:ss.zzz.

Si format est Qt::RFC2822Date, la chaîne est formatée d'une manière compatible avec la 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 aussi fromString(), QDate::toString(), QDateTime::toString(), et QLocale::toString().