Obsolete Members for QDateTime

Les membres suivants de la classe QDateTime sont obsolètes. Ils sont fournis pour permettre aux anciens codes sources de continuer à fonctionner. Il est fortement déconseillé de les utiliser dans un 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. Il est fortement déconseillé de l'utiliser dans un nouveau code.

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

Construit une date avec les données date et time, en utilisant la représentation du temps impliquée par spec et offsetSeconds secondes.

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

Si spec n'est pas Qt::OffsetFromUTC, offsetSeconds sera ignoré. Si spec est Qt::OffsetFromUTC et offsetSeconds est 0, timeSpec() sera mis à Qt::UTC, c'est-à-dire un décalage de 0 seconde.

Si spec est Qt::TimeZone, la valeur de spec sera Qt::LocalTime, c'est-à-dire le fuseau horaire actuel du système. Pour créer une datetime Qt::TimeZone, utilisez le constructeur approprié.

Si date se situe en dehors de la plage des dates représentables par QDateTime, le résultat n'est pas valide. Si spec est Qt::LocalTime et que le fuseau horaire du système a sauté la date et l'heure donné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. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Passez un QTimeZone à la place, ou omettez spec et offsetSeconds.

Renvoie une date représentant un moment du nombre donné msecs de millisecondes après le début, en UTC, de l'année 1970, décrite comme 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, à la fois négatives et positives. Le comportement de cette fonction n'est pas défini pour ces valeurs.

Si spec n'est pas Qt::OffsetFromUTC, offsetSeconds sera ignoré. Si spec est Qt::OffsetFromUTC et offsetSeconds est 0, Qt::UTC sera utilisé comme spec, puisque UTC a un décalage de zéro.

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

Voir aussi 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. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Passez un QTimeZone à la place, ou omettez spec et offsetSeconds.

Renvoie un datetime représentant un moment du nombre donné secs de secondes après le début, en UTC, de l'année 1970, décrit comme spécifié par spec et offsetSeconds.

Notez qu'il existe des valeurs possibles pour secs qui se situent en dehors de la plage valide de QDateTime, à la fois négatives et positives. Le comportement de cette fonction n'est pas défini pour ces valeurs.

Si spec n'est pas Qt::OffsetFromUTC, offsetSeconds sera ignoré. Si spec est Qt::OffsetFromUTC et offsetSeconds est 0, Qt::UTC sera utilisé comme spec, puisque UTC a un décalage de zéro.

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

Voir aussi fromMSecsSinceEpoch(), toSecsSinceEpoch(), et setSecsSinceEpoch().

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

Cette fonction est obsolète depuis la version 6.9. Il est fortement déconseillé de l'utiliser dans un nouveau code.

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

Fixe timeSpec() à Qt::OffsetFromUTC et le décalage à offsetSeconds. La date peut se référer à un moment différent dans le temps.

Les décalages maximum et minimum sont de 14 heures positives ou négatives. Si offsetSeconds est plus grand ou plus petit que cela, le résultat est indéfini.

Si offsetSeconds est égal à 0, la valeur de timeSpec() sera égale à 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. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt setTimeZone()

Définit la spécification de temps utilisée dans cette datetime à spec. La datetime peut se référer à un moment différent dans le temps.

Si spec est Qt::OffsetFromUTC, la valeur de timeSpec() sera Qt::UTC, soit un décalage effectif de 0.

Si spec est Qt::TimeZone, la spécification sera réglée sur Qt::LocalTime, c'est-à-dire sur 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 aussi 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. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt toTimeZone().

Renvoie une copie de cette datetime convertie au temps donné spec.

Le résultat représente le même moment dans le temps que, et est égal à, cette date.

Si spec est Qt::OffsetFromUTC, il est défini à Qt::UTC. Pour définir un décalage fixe par rapport à UTC, utilisez toTimeZone() ou toOffsetFromUtc().

Si spec est Qt::TimeZone, il est défini sur Qt::LocalTime, c'est-à-dire sur 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 aussi setTimeSpec(), timeSpec() et toTimeZone().