Obsolete Members for QDateTime

Les membres suivants de la classe ` QDateTime ` sont obsolètes. Ils sont fournis afin de garantir la compatibilité avec l'ancien code source. Nous déconseillons fortement de les utiliser dans du nouveau code.

Fonctions publiques

Membres publics statiques

Documentation des fonctions membres

[deprecated in 6.9] QDateTime::QDateTime(QDate date, QTime time, Qt::TimeSpec spec, int offsetSeconds = 0)

Cette fonction est obsolète depuis la version 6.9. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez plutôt QDateTime(date, time) ou QDateTime(date, time, QTimeZone::fromSecondsAheadOfUtc(offsetSeconds)).

Construit une date-heure à partir des valeurs fournies par ` date ` et ` time`, en utilisant la représentation temporelle impliquée par ` spec ` et ` offsetSeconds ` secondes.

Si date est valide et que time ne l’est pas, l’heure sera fixée à minuit.

Si spec n’est pas Qt::OffsetFromUTC, alors offsetSeconds sera ignoré. Si spec est Qt::OffsetFromUTC et offsetSeconds est 0, alors la fonction timeSpec() sera définie sur Qt::UTC, c’est-à-dire un décalage de 0 seconde.

Si spec vaut Qt::TimeZone, alors la spécification sera définie sur Qt::LocalTime, c’est-à-dire le fuseau horaire actuel du système. Pour créer un objet Qt::TimeZone de type date-heure, utilisez le constructeur approprié.

Si ` date ` se situe en dehors de la plage de dates représentables par `QDateTime`, le résultat n’est pas valide. Si ` spec ` correspond à ` Qt::LocalTime ` et que le fuseau horaire du système a dépassé la date et l’heure indiquées, le résultat n’est pas valide.

[static, deprecated in 6.9] QDateTime QDateTime::fromMSecsSinceEpoch(qint64 msecs, Qt::TimeSpec spec, int offsetSeconds = 0)

Cette fonction est obsolète depuis la version 6.9. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Passez plutôt un nombre d'QTimeZone, ou omettez les paramètres spec et offsetSeconds.

Renvoie une date-heure représentant un instant situé à msecs millisecondes après le début, en UTC, de l'année 1970, tel que spécifié par spec et offsetSeconds.

Notez qu’il existe des valeurs possibles pour msecs qui se situent en dehors de la plage valide de QDateTime, qu’elles soient négatives ou positives. Le comportement de cette fonction est indéfini pour ces valeurs.

Si la valeur de spec n’est pas celle de Qt::OffsetFromUTC, alors la valeur de offsetSeconds sera ignorée. Si la valeur de spec correspond à Qt::OffsetFromUTC et que la valeur de offsetSeconds est égale à 0, alors Qt::UTC sera utilisé comme spec, puisque l’UTC a un décalage nul.

Si spec vaut Qt::TimeZone, alors Qt::LocalTime sera utilisé à la place, ce qui équivaut à utiliser le fuseau horaire actuel du système (mais représenté différemment).

Voir également fromSecsSinceEpoch(), toMSecsSinceEpoch() et setMSecsSinceEpoch().

[static, deprecated in 6.9] QDateTime QDateTime::fromSecsSinceEpoch(qint64 secs, Qt::TimeSpec spec, int offsetSeconds = 0)

Cette fonction est obsolète depuis la version 6.9. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez plutôt un nombre d'QTimeZone, ou omettez spec et offsetSeconds.

Renvoie une date-heure représentant un instant situé à secs secondes après le début de l’année 1970, en UTC, tel que défini par spec et offsetSeconds.

Notez qu’il existe des valeurs possibles pour secs qui se situent en dehors de la plage valide de QDateTime, qu’elles soient négatives ou positives. Le comportement de cette fonction est indéfini pour ces valeurs.

Si la valeur de spec n’est pas celle de Qt::OffsetFromUTC, alors la valeur de offsetSeconds sera ignorée. Si la valeur de spec est Qt::OffsetFromUTC et que celle de offsetSeconds est 0, alors Qt::UTC sera utilisé comme spec, puisque l’UTC a un décalage nul.

Si spec vaut Qt::TimeZone, alors Qt::LocalTime sera utilisé à la place, ce qui équivaut à utiliser le fuseau horaire actuel du système (mais représenté différemment).

Voir également fromMSecsSinceEpoch(), toSecsSinceEpoch() et setSecsSinceEpoch().

[deprecated in 6.9] void QDateTime::setOffsetFromUtc(int offsetSeconds)

Cette fonction est obsolète depuis la version 6.9. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez plutôt ` setTimeZone(QTimeZone::fromSecondsAheadOfUtc(offsetSeconds))`.

Définit la date et l'heure ( timeSpec()) sur Qt::OffsetFromUTC et le décalage sur offsetSeconds. La date et l'heure peuvent correspondre à un moment différent.

Le décalage maximal et minimal est de 14 heures, positives ou négatives. Si offsetSeconds est supérieur ou inférieur à cette valeur, le résultat est indéfini.

Si offsetSeconds est égal à 0, alors timeSpec() sera défini sur Qt::UTC.

Voir également setTimeZone(), isValid(), offsetFromUtc() et toOffsetFromUtc().

[deprecated in 6.9] void QDateTime::setTimeSpec(Qt::TimeSpec spec)

Cette fonction est obsolète depuis la version 6.9. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez plutôt setTimeZone().

Définit le format de date utilisé dans cet objet `datetime` sur ` spec`. L'objet `datetime` peut faire référence à un moment différent.

Si ` spec ` est ` Qt::OffsetFromUTC `, alors ` timeSpec()` sera défini sur ` Qt::UTC`, c'est-à-dire un décalage effectif de 0.

Si ` spec ` vaut ` Qt::TimeZone `, alors `spec` sera défini sur ` Qt::LocalTime`, c'est-à-dire le fuseau horaire actuel du système.

Exemple :

QDateTime local(QDateTime::currentDateTime());
qDebug() << "Local time is:" << local;

QDateTime UTC(local) ;
UTC.setTimeSpec(Qt::UTC) ;
qDebug() << "UTC time is:" << UTC;

qDebug() << "There are" << local.secsTo(UTC) << "seconds difference between the datetimes.";

Voir également setTimeZone(), timeSpec(), toTimeSpec(), setDate() et setTime().

[deprecated in 6.9] QDateTime QDateTime::toTimeSpec(Qt::TimeSpec spec) const

Cette fonction est obsolète depuis la version 6.9. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez plutôt toTimeZone().

Renvoie une copie de cet objet `datetime` convertie à l'heure indiquée par ` spec`.

Le résultat représente le même instant que cette date-heure et est égal à celle-ci.

Si spec est Qt::OffsetFromUTC, alors la valeur est définie sur Qt::UTC. Pour définir un décalage fixe par rapport à l'UTC, utilisez toTimeZone() ou toOffsetFromUtc().

Si spec vaut Qt::TimeZone, la valeur par défaut est Qt::LocalTime, c'est-à-dire le fuseau horaire local. Pour définir un fuseau horaire spécifique, utilisez toTimeZone().

Exemple :

QDateTime local(QDateTime::currentDateTime());
QDateTime UTC(local.toTimeSpec(Qt::UTC));
qDebug() << "Local time is:" << local;
qDebug() << "UTC time is:" << UTC;
qDebug() << "No difference between times:" << local.secsTo(UTC);

Voir également setTimeSpec(), timeSpec() et toTimeZone().