QDateTime Class

Documentation des fonctions membres

QDateTime::QDateTime(QDate date, QTime time, const QTimeZone &timeZone, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

Construit une date avec les données date et time, en utilisant la représentation du temps décrite par timeZone.

Si date est valide et time ne l'est pas, l'heure sera fixée à minuit. Si timeZone n'est pas valide, la date sera invalide. Si date et time décrivent un moment proche d'une transition pour timeZone, resolve contrôle la manière dont cette situation est résolue.

[noexcept] QDateTime::QDateTime()

Construit une date nulle, en utilisant nominalement l'heure locale.

Une date nulle n'est pas valide, puisque sa date et son heure ne le sont pas.

Voir aussi isValid(), setMSecsSinceEpoch(), setDate(), setTime(), et setTimeZone().

[since 6.5] QDateTime::QDateTime(QDate date, QTime time, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

Construit une date avec les données date et time, en utilisant l'heure locale.

Si date est valide et que time ne l'est pas, l'heure sera minuit. Si date et time décrivent un moment proche d'une transition pour l'heure locale, resolve contrôle la façon dont cette situation est résolue.

Cette fonction a été introduite dans Qt 6.5.

[noexcept] QDateTime::QDateTime(const QDateTime &other)

Construit une copie de la date other.

[noexcept] QDateTime::QDateTime(QDateTime &&other)

Déplace le contenu de la date temporaire other vers cet objet et laisse other dans un état non spécifié (mais correct).

[noexcept] QDateTime::~QDateTime()

Détruit la date.

QDateTime QDateTime::addDays(qint64 ndays) const

Renvoie un objet QDateTime contenant une date ndays qui est postérieure à la date de cet objet (ou antérieure si ndays est négatif).

Si timeSpec() est Qt::LocalTime ou Qt::TimeZone et que la date et l'heure résultantes se situent dans l'heure de transition entre l'heure normale et l'heure d'été, le résultat sera juste au-delà de cet écart, dans le sens du changement. Si la transition a lieu à 2 heures du matin et que l'horloge avance à 3 heures, le résultat de la visée entre 2 heures et 3 heures sera ajusté pour tomber avant 2 heures (si ndays < 0) ou après 3 heures (dans le cas contraire).

Voir également daysTo(), addMonths(), addYears(), addSecs() et Timezone transitions.

[since 6.4] QDateTime QDateTime::addDuration(std::chrono::milliseconds msecs) const

Renvoie un objet QDateTime contenant une date msecs millisecondes plus tard que la date de cet objet (ou plus tôt si msecs est négatif).

Si cette date n'est pas valide, une date invalide sera retournée.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi addMSecs(), msecsTo(), addDays(), addMonths(), et addYears().

QDateTime QDateTime::addMSecs(qint64 msecs) const

Renvoie un objet QDateTime contenant une date msecs millisecondes plus tard que la date de cet objet (ou plus tôt si msecs est négatif).

Si cette date n'est pas valide, une date invalide sera renvoyée.

Voir aussi addSecs(), msecsTo(), addDays(), addMonths() et addYears().

QDateTime QDateTime::addMonths(int nmonths) const

Renvoie un objet QDateTime contenant une date nmonths mois plus tard que la date de cet objet (ou plus tôt si nmonths est négatif).

Si timeSpec() est Qt::LocalTime ou Qt::TimeZone et que la date et l'heure résultantes tombent dans l'heure de transition entre l'heure normale et l'heure d'été, le résultat se situera juste au-delà de cet écart, dans le sens du changement. Si la transition a lieu à 2 heures du matin et que l'horloge avance à 3 heures, le résultat de la visée entre 2 heures et 3 heures sera ajusté pour tomber avant 2 heures (si nmonths < 0) ou après 3 heures (dans le cas contraire).

Voir également daysTo(), addDays(), addYears(), addSecs() et Timezone transitions.

QDateTime QDateTime::addSecs(qint64 s) const

Renvoie un objet QDateTime contenant une date s qui est postérieure de quelques secondes à la date de cet objet (ou antérieure si s est négatif).

Si cette date n'est pas valide, une date invalide sera renvoyée.

Voir aussi addMSecs(), secsTo(), addDays(), addMonths() et addYears().

QDateTime QDateTime::addYears(int nyears) const

Renvoie un objet QDateTime contenant une date nyears postérieure d'un an à la date de cet objet (ou antérieure si nyears est négatif).

Si timeSpec() est Qt::LocalTime ou Qt::TimeZone et que la date et l'heure résultantes se situent dans l'heure de transition entre l'heure normale et l'heure d'été, le résultat sera juste au-delà de cet écart, dans le sens du changement. Si la transition a lieu à 2 heures du matin et que l'horloge avance à 3 heures, le résultat de la visée entre 2 heures et 3 heures sera ajusté pour tomber avant 2 heures (si nyears < 0) ou après 3 heures (dans le cas contraire).

Voir également daysTo(), addDays(), addMonths(), addSecs() et Timezone transitions.

[static, since 6.5] QDateTime QDateTime::currentDateTime(const QTimeZone &zone)

Renvoie l'heure actuelle de l'horloge système, en utilisant la représentation du temps décrite par zone. Si zone est omis, l'heure locale est utilisée.

Cette fonction a été introduite dans Qt 6.5.

Voir aussi currentDateTimeUtc(), QDate::currentDate(), QTime::currentTime(), et toTimeZone().

[static] QDateTime QDateTime::currentDateTime()

[static] QDateTime QDateTime::currentDateTimeUtc()

Renvoie l'heure actuelle de l'horloge du système, exprimée en termes d'UTC.

Équivalent à currentDateTime(QTimeZone::UTC).

Voir aussi currentDateTime(), QDate::currentDate(), QTime::currentTime(), et toTimeZone().

[static noexcept] qint64 QDateTime::currentMSecsSinceEpoch()

Renvoie le nombre actuel de millisecondes depuis le début, en UTC, de l'année 1970.

Ce nombre est similaire à la variable POSIX time_t, mais exprimé en millisecondes au lieu de secondes.

Voir aussi currentDateTime(), currentDateTimeUtc(), et toTimeZone().

[static noexcept] qint64 QDateTime::currentSecsSinceEpoch()

Renvoie le nombre de secondes écoulées depuis le début, en UTC, de l'année 1970.

Ce nombre est similaire à la variable POSIX time_t.

Voir aussi currentMSecsSinceEpoch().

QDate QDateTime::date() const

Renvoie la partie date de l'heure de la date.

Voir aussi setDate(), time(), et timeRepresentation().

qint64 QDateTime::daysTo(const QDateTime &other) const

Renvoie le nombre de jours entre cette date et la date other. Le nombre de jours est compté comme le nombre de fois où minuit est atteint entre cette date et la date other. Cela signifie qu'une différence de 10 minutes entre 23:55 et 0:05 le jour suivant compte pour un jour.

Si la date other est antérieure à cette date, la valeur renvoyée est négative.

Exemple :

QDateTime startDate(QDate(2012, 7, 6), QTime(8, 30, 0)) ;QDateTime endDate(QDate(2012, 7, 7), QTime(16, 30, 0)) ;qDebug() << "Days from startDate to endDate: " << startDate.daysTo(endDate);

startDate = QDateTime(QDate(2012, 7, 6), QTime(23, 55, 0)) ; endDate = QDateTime(QDate(2012, 7, 7), QTime(0, 5, 0)) ;qDebug() << "Days from startDate to endDate: " << startDate.daysTo(endDate);

qSwap(startDate, endDate); // Make endDate before startDate.
qDebug() << "Days from startDate to endDate: " << startDate.daysTo(endDate);

Voir aussi addDays(), secsTo() et msecsTo().

[static] QDateTime QDateTime::fromCFDate(CFDateRef date)

Construit un nouveau QDateTime contenant une copie du CFDate date.

Voir aussi toCFDate().

[static] QDateTime QDateTime::fromMSecsSinceEpoch(qint64 msecs, const QTimeZone &timeZone)

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 timeZone. La représentation temporelle par défaut est l'heure locale.

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 est indéfini pour ces valeurs.

Voir aussi fromSecsSinceEpoch(), toMSecsSinceEpoch() et setMSecsSinceEpoch().

[static] QDateTime QDateTime::fromMSecsSinceEpoch(qint64 msecs)

[static] QDateTime QDateTime::fromNSDate(const NSDate *date)

Construit un nouveau QDateTime contenant une copie du NSDate date.

Voir aussi toNSDate().

[static] QDateTime QDateTime::fromSecsSinceEpoch(qint64 secs, const QTimeZone &timeZone)

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 timeZone. La représentation temporelle par défaut est l'heure locale.

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 est indéfini pour ces valeurs.

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

[static] QDateTime QDateTime::fromSecsSinceEpoch(qint64 secs)

[static, since 6.4] QDateTime QDateTime::fromStdLocalTime(const std::chrono::local_time<std::chrono::milliseconds> &time)

Construit un datetime dont la date et l'heure sont le nombre de millisecondes représenté par time, compté depuis 1970-01-01T00:00:00.000 en heure locale (Qt::LocalTime).

Cette fonction a été introduite dans Qt 6.4.

Voir aussi toStdSysMilliseconds() et fromMSecsSinceEpoch().

[static, since 6.4] template <typename Clock, typename Duration> QDateTime QDateTime::fromStdTimePoint(const std::chrono::time_point<Clock, Duration> &time)

Construit une date représentant le même point dans le temps que time, en utilisant Qt::UTC comme représentation du temps.

L'horloge de time doit être compatible avec std::chrono::system_clock; en particulier, une conversion supportée par std::chrono::clock_cast doit exister. Après la conversion, le type de durée du résultat doit être convertible en std::chrono::milliseconds.

Si ce n'est pas le cas, l'appelant doit effectuer la conversion d'horloge nécessaire vers std::chrono::system_clock et la conversion nécessaire du type de durée (coulé/rond/plancher/voile/...) afin que l'entrée de cette fonction satisfasse aux contraintes ci-dessus.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi toStdSysMilliseconds() et fromMSecsSinceEpoch().

[static, since 6.4] QDateTime QDateTime::fromStdTimePoint(const std::chrono::local_time<std::chrono::milliseconds> &time)

Construit un datetime dont la date et l'heure sont le nombre de millisecondes représenté par time, compté depuis 1970-01-01T00:00:00.000 en heure locale (Qt::LocalTime).

Cette fonction a été introduite dans Qt 6.4.

Voir aussi toStdSysMilliseconds() et fromMSecsSinceEpoch().

[static, since 6.4] QDateTime QDateTime::fromStdTimePoint(std::chrono::time_point<std::chrono::system_clock, std::chrono::milliseconds> time)

Construit une date représentant le même point dans le temps que time, en utilisant Qt::UTC comme représentation du temps.

Cette fonction a été introduite dans Qt 6.4.

[static, since 6.4] QDateTime QDateTime::fromStdZonedTime(const int &time)

Construit une date représentant le même point dans le temps que time. Le résultat sera exprimé dans le fuseau horaire de time.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi QTimeZone, toStdSysMilliseconds(), et fromMSecsSinceEpoch().

[static] QDateTime QDateTime::fromString(const QString &string, const QString &format, int baseYear, QCalendar cal)

Retourne le QDateTime représenté par le string, en utilisant le format donné, ou une date invalide si la chaîne ne peut pas être analysée.

Utilise le calendrier cal s'il est fourni, sinon le calendrier grégorien.

Lorsque format ne spécifie que les deux derniers chiffres d'une année, les 100 années commençant à baseYear sont les premières candidates prises en compte. Avant la version 6.7, il n'y avait pas de paramètre baseYear et 1900 était toujours utilisé. C'est la valeur par défaut de baseYear, qui sélectionne une année entre cette date et 1999. Dans certains cas, d'autres champs peuvent conduire à la sélection du siècle suivant ou précédent, afin d'obtenir un résultat cohérent avec tous les champs fournis. Voir QDate::fromString() pour plus de détails.

Outre les expressions reconnues dans la chaîne de format pour représenter des parties de la date et de l'heure, par QDate::fromString() et QTime::fromString(), cette méthode prend en charge les expressions suivantes :

Si le spécificateur de format 't' n'est pas présent, le fuseau horaire local du système est utilisé. Pour les valeurs par défaut de tous les autres champs, voir QDate::fromString() et QTime::fromString().

Par exemple :

QDateTime dateTime = QDateTime::fromString("1.30.1", "M.d.s");
// dateTime is January 30 in 1900 at 00:00:01.
dateTime = QDateTime::fromString("12", "yy");
// dateTime is January 1 in 1912 at 00:00:00.

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 time1 = QTime::fromString("131", "HHh");
// time1 is 13:00:00
QTime time2 = QTime::fromString("1apA", "1amAM");
// time2 is 01:00:00

QDateTime dateTime2 = QDateTime::fromString("M1d1y9800:01:02",
                                            "'M'M'd'd'y'yyhh:mm:ss");
// dateTime is 1 January 1998 00:01:02

Si le format n'est pas respecté, une adresse QDateTime invalide est renvoyée. Si le format est respecté mais que string représente une date non valide (par exemple, dans un intervalle ignoré par une transition de fuseau horaire), un QDateTime valide est renvoyé, qui représente une date proche qui est valide.

Les expressions qui n'ont pas de zéro en tête (d, M, h, m, s, z) seront gourmandes. Cela signifie qu'elles utiliseront deux chiffres (ou trois, pour z) même si cela les place en dehors de la plage et/ou laisse trop peu de chiffres pour les autres sections.

QDateTime dateTime = QDateTime::fromString("130", "Mm"); // invalid

Cela aurait pu signifier 1 janvier 00:30.00 mais le M prendra deux chiffres.

Les champs de string mal spécifiés entraîneront le renvoi d'un QDateTime non valide. Seules les dates comprises entre le début de l'année 100 et la fin de l'année 9999 sont prises en charge. Notez que les dates proches des extrémités de cette plage dans d'autres fuseaux horaires, y compris UTC, peuvent se situer en dehors de la plage (et donc être traitées comme invalides) en fonction du fuseau horaire local.

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

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

Cette fonction a été introduite dans Qt 6.0.

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

Retourne le QDateTime représenté par le string, en utilisant le format donné, ou une date invalide si cela n'est pas possible.

Note pour Qt::TextDate: seuls les noms de mois courts en anglais (par exemple "Jan" en forme courte ou "January" en forme longue) sont reconnus.

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

[static, since 6.0] QDateTime QDateTime::fromString(QStringView string, QStringView format, QCalendar cal)

Cette fonction a été introduite dans Qt 6.0.

[static, since 6.7] QDateTime QDateTime::fromString(QStringView string, QStringView format, int baseYear = QLocale::DefaultTwoDigitBaseYear)

Utilise une construction par défaut QCalendar.

Cette fonction a été introduite dans Qt 6.7.

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

Cette fonction a été introduite dans Qt 6.0.

[static, since 6.7] QDateTime QDateTime::fromString(const QString &string, QStringView format, int baseYear = QLocale::DefaultTwoDigitBaseYear)

Utilise une construction par défaut QCalendar.

Cette fonction a été introduite dans Qt 6.7.

[static] QDateTime QDateTime::fromString(const QString &string, const QString &format, QCalendar cal)

[static, since 6.7] QDateTime QDateTime::fromString(const QString &string, const QString &format, int baseYear = QLocale::DefaultTwoDigitBaseYear)

Utilise une construction par défaut QCalendar.

Cette fonction a été introduite dans Qt 6.7.

[static, since 6.7] QDateTime QDateTime::fromString(QStringView string, QStringView format, int baseYear, QCalendar cal)

Cette fonction a été introduite dans Qt 6.7.

[static, since 6.0] QDateTime QDateTime::fromString(const QString &string, QStringView format, int baseYear, QCalendar cal)

Cette fonction a été introduite dans Qt 6.0.

bool QDateTime::isDaylightTime() const

Renvoie si cette date tombe dans l'heure d'été.

Si Qt::TimeSpec n'est pas Qt::LocalTime ou Qt::TimeZone, le résultat sera toujours faux.

Voir aussi timeSpec().

bool QDateTime::isNull() const

Renvoie true si la date et l'heure sont toutes deux nulles ; sinon, renvoie false. Une date nulle n'est pas valide.

Voir aussi QDate::isNull(), QTime::isNull(), et isValid().

bool QDateTime::isValid() const

Renvoie true si cette date représente un moment précis, sinon false.

Une date est valide si la date et l'heure sont valides et si la représentation du temps utilisée donne une signification valide à leur combinaison. Lorsque la représentation du temps est un fuseau horaire spécifique ou l'heure locale, il peut y avoir des moments à certaines dates que le fuseau saute dans sa représentation, comme lorsqu'un passage à l'heure d'été saute une heure (typiquement pendant une nuit au printemps). Par exemple, si l'heure d'été se termine à 2 heures du matin et que l'horloge avance à 3 heures, les dates comprises entre 02:00:00 et 02:59:59.999 ce jour-là ne sont pas valides.

Voir également QDateTime::YearRange, QDate::isValid(), et QTime::isValid().

qint64 QDateTime::msecsTo(const QDateTime &other) const

Renvoie le nombre de millisecondes entre cette date et la date other. Si la date other est antérieure à cette date, la valeur renvoyée est négative.

Avant d'effectuer la comparaison, les deux dates sont converties en Qt::UTC pour s'assurer que le résultat est correct si l'heure d'été (DST) s'applique à l'une des deux dates et pas à l'autre.

Renvoie 0 si l'une des deux dates n'est pas valide.

Voir aussi addMSecs(), daysTo(), et QTime::msecsTo().

int QDateTime::offsetFromUtc() const

Renvoie le décalage de cette date par rapport à l'UTC en secondes.

Le résultat dépend de timeSpec() :

• Qt::UTC Le décalage est de 0.
• Qt::OffsetFromUTC Le décalage est la valeur définie à l'origine.
• Qt::LocalTime Le décalage de l'heure locale par rapport à UTC est renvoyé.
• Qt::TimeZone Le décalage utilisé par le fuseau horaire est renvoyé.

Pour les deux derniers, le décalage à cette date et heure sera renvoyé, en tenant compte du décalage de l'heure d'été. Le décalage est la différence entre l'heure locale ou l'heure du fuseau horaire donné et l'heure UTC ; il est positif dans les fuseaux horaires en avance sur UTC (à l'est du méridien d'origine), négatif pour ceux qui sont en retard sur UTC (à l'ouest du méridien d'origine).

Voir également setTimeZone().

qint64 QDateTime::secsTo(const QDateTime &other) const

Renvoie le nombre de secondes entre cette date et la date other. Si la date other est antérieure à cette date, la valeur renvoyée est négative.

Avant d'effectuer la comparaison, les deux dates sont converties en Qt::UTC pour s'assurer que le résultat est correct si l'heure d'été (DST) s'applique à l'une des deux dates mais pas à l'autre.

Renvoie 0 si l'une des deux dates n'est pas valide.

Exemple :

QDateTime now = QDateTime::currentDateTime() ;QDateTime xmas(QDate(now.date().year(), 12, 25).startOfDay()) ;qDebug("There are %d seconds to Christmas", now.secsTo(xmas));

Voir aussi addSecs(), daysTo() et QTime::secsTo().

void QDateTime::setDate(QDate date, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

Fixe la partie date de cette date à date.

Si aucune heure n'est encore définie, elle est fixée à minuit. Si date est invalide, QDateTime le devient aussi.

Si date et time() décrivent un moment proche d'une transition pour la représentation temporelle de cette date, resolve contrôle la façon dont cette situation est résolue.

Voir aussi date(), setTime(), et setTimeZone().

void QDateTime::setMSecsSinceEpoch(qint64 msecs)

Définit l'heure de la date pour qu'elle représente un moment un nombre donné, msecs, de millisecondes après le début, en UTC, de l'année 1970.

Sur les systèmes qui ne prennent pas en charge les fuseaux horaires, cette fonction se comportera comme si l'heure locale était Qt::UTC.

Notez que le fait de passer le minimum de qint64 (std::numeric_limits<qint64>::min()) à msecs entraînera un comportement indéfini.

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

void QDateTime::setSecsSinceEpoch(qint64 secs)

Définit l'heure de la date pour qu'elle représente un moment un nombre donné, secs, de secondes après le début, en UTC, de l'année 1970.

Sur les systèmes qui ne prennent pas en charge les fuseaux horaires, cette fonction se comportera comme si l'heure locale était Qt::UTC.

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

void QDateTime::setTime(QTime time, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

Fixe la partie temporelle de cette date à time. Si time n'est pas valide, cette fonction la fixe à minuit. Par conséquent, il est possible d'effacer n'importe quelle heure définie dans QDateTime en lui attribuant la valeur par défaut QTime:

QDateTime dt = QDateTime::currentDateTime();
dt.setTime(QTime());

Si date() et time décrivent un moment proche d'une transition pour la représentation temporelle de cette date, resolve contrôle la manière dont cette situation est résolue.

Voir aussi time(), setDate(), et setTimeZone().

void QDateTime::setTimeZone(const QTimeZone &toZone, QDateTime::TransitionResolution resolve = TransitionResolution::LegacyBehavior)

Définit le fuseau horaire utilisé dans cette date à toZone.

L'heure de la date peut faire référence à un moment différent dans le temps. Elle utilise la représentation temporelle de toZone, ce qui peut modifier la signification des valeurs inchangées date() et time().

Si toZone n'est pas valide, l'heure de la date ne le sera pas non plus. Dans le cas contraire, l'heure de cette date timeSpec() après l'appel correspondra à toZone.timeSpec().

Si date() et time() décrivent un moment proche d'une transition pour toZone, resolve contrôle la manière dont cette situation est résolue.

Voir aussi timeRepresentation(), timeZone(), et Qt::TimeSpec.

[noexcept] void QDateTime::swap(QDateTime &other)

Remplace cette date par other. Cette opération est très rapide et n'échoue jamais.

QTime QDateTime::time() const

Renvoie la partie temporelle de la date.

Voir aussi setTime(), date(), et timeRepresentation().

[since 6.5] QTimeZone QDateTime::timeRepresentation() const

Renvoie un QTimeZone identifiant la manière dont ce datetime représente le temps.

Le timeSpec() du QTimeZone renvoyé coïncide avec celui de cette date ; s'il n'est pas Qt::TimeZone, le QTimeZone renvoyé est une représentation du temps. Lorsque timeSpec() est Qt::OffsetFromUTC, le fixedSecondsAheadOfUtc() de QTimeZone fournit le décalage. Lorsque timeSpec() est Qt::TimeZone, l'objet QTimeZone lui-même est la représentation complète de ce fuseau horaire.

Cette fonction a été introduite dans Qt 6.5.

Voir également timeZone(), setTimeZone() et QTimeZone::asBackendZone().

Qt::TimeSpec QDateTime::timeSpec() const

Renvoie la spécification temporelle de la date.

La représentation de l'heure est classée comme suit : heure locale, UTC, décalage fixe par rapport à UTC (sans indiquer le décalage) ou fuseau horaire (sans donner les détails de ce fuseau horaire). Équivalent à timeRepresentation().timeSpec().

Voir également setTimeZone(), timeRepresentation(), date() et time().

QTimeZone QDateTime::timeZone() const

Renvoie le fuseau horaire de la date.

Le résultat est identique à timeRepresentation().asBackendZone(). Dans tous les cas, le résultat timeSpec() est Qt::TimeZone.

Lorsque timeSpec() est Qt::LocalTime, le résultat décrit l'heure locale au moment où cette méthode a été appelée. Il ne reflétera pas les changements ultérieurs du fuseau horaire du système, même si le site QDateTime à partir duquel il a été obtenu le fait.

Voir également timeRepresentation(), setTimeZone(), Qt::TimeSpec et QTimeZone::asBackendZone().

QString QDateTime::timeZoneAbbreviation() const

Renvoie l'abréviation du fuseau horaire pour cette date.

La chaîne renvoyée dépend de timeSpec() :

• Pour Qt::UTC, il s'agit de "UTC".
• Pour Qt::OffsetFromUTC, elle sera au format "UTC±00:00".
• Pour Qt::LocalTime, le système hôte est interrogé.
• Pour Qt::TimeZone, l'objet associé QTimeZone est interrogé.

Voir aussi timeSpec() et QTimeZone::abbreviation().

CFDateRef QDateTime::toCFDate() const

Crée un CFDate à partir d'un QDateTime.

L'appelant est propriétaire de l'objet CFDate et est responsable de sa libération.

Voir aussi fromCFDate().

QDateTime QDateTime::toLocalTime() const

Renvoie une copie de cette date convertie en heure locale.

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

Exemple :

QDateTime UTC(QDateTime::currentDateTimeUtc()) ;QDateTime local(UTC.toLocalTime()) ;qDebug() << "UTC time is:" << UTC;
qDebug() << "Local time is:" << local;
qDebug() << "No difference between times:" << UTC.secsTo(local);

Voir aussi toTimeZone(), toUTC() et toOffsetFromUtc().

qint64 QDateTime::toMSecsSinceEpoch() const

Renvoie la date sous la forme d'un nombre de millisecondes après le début, en UTC, de l'année 1970.

Sur les systèmes qui ne prennent pas en charge les fuseaux horaires, cette fonction se comportera comme si l'heure locale était Qt::UTC.

Le comportement de cette fonction est indéfini si la date stockée dans cet objet n'est pas valide. Cependant, pour toutes les dates valides, cette fonction renvoie une valeur unique.

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

NSDate *QDateTime::toNSDate() const

Crée un NSDate à partir d'un QDateTime.

L'objet NSDate est libéré automatiquement.

Voir aussi fromNSDate().

QDateTime QDateTime::toOffsetFromUtc(int offsetSeconds) const

Renvoie une copie de cette date convertie en un spécimen de Qt::OffsetFromUTC avec la valeur donnée offsetSeconds. Équivalent à toTimeZone(QTimeZone::fromSecondsAheadOfUtc(offsetSeconds)).

Si offsetSeconds est égal à 0, une date UTC sera renvoyée.

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

Voir aussi offsetFromUtc() et toTimeZone().

qint64 QDateTime::toSecsSinceEpoch() const

Renvoie la date en tant que nombre de secondes après le début, en UTC, de l'année 1970.

Sur les systèmes qui ne prennent pas en charge les fuseaux horaires, cette fonction se comportera comme si l'heure locale était Qt::UTC.

Le comportement de cette fonction est indéfini si la date stockée dans cet objet n'est pas valide. Cependant, pour toutes les dates valides, cette fonction renvoie une valeur unique.

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

[since 6.4] std::chrono::sys_time<std::chrono::milliseconds> QDateTime::toStdSysMilliseconds() const

Convertit cet objet datetime en un point temporel équivalent exprimé en millisecondes, en utilisant std::chrono::system_clock comme horloge.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi fromStdTimePoint() et toMSecsSinceEpoch().

[since 6.4] std::chrono::sys_seconds QDateTime::toStdSysSeconds() const

Convertit cet objet datetime en un point temporel équivalent exprimé en secondes, en utilisant std::chrono::system_clock comme horloge.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi fromStdTimePoint() et toSecsSinceEpoch().

Renvoie la date sous forme de chaîne de caractères. Le paramètre format détermine le format de la chaîne de résultat. Si cal est fourni, il détermine le calendrier utilisé pour représenter la date ; par défaut, il s'agit du calendrier grégorien. Avant la version 5.14 de Qt, il n'y avait pas de paramètre cal et le calendrier grégorien était toujours utilisé. Voir QTime::toString() et QDate::toString() pour les spécificateurs pris en charge pour l'heure et la date, respectivement, dans le paramètre format.

Toute séquence de caractères entre guillemets simples sera incluse intégralement 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 le résultat. 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 "ddMM") 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 "dM" produit "212", cela peut signifier soit le 2 décembre, soit le 21 février).

Exemples de chaînes de format (en supposant que le site QDateTime est le 21 mai 2001 14:13:09.120) :

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

Voir aussi fromString(), QDate::toString(), QTime::toString() et QLocale::toString().

QString QDateTime::toString(QStringView format) const

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

Renvoie la date sous la forme d'une chaîne de caractères dans l'adresse format indiquée.

Si format est Qt::TextDate, la chaîne est formatée par défaut. Les noms du jour et du mois seront en anglais. Un exemple de ce formatage est "Wed May 20 03:40:13 1998". Pour un formatage localisé, voir QLocale::toString().

Si format est Qt::ISODate, le format de la chaîne correspond à la spécification ISO 8601 étendue pour les représentations de dates et d'heures, prenant la forme aaaa-MM-ddTHH:mm:ss[Z|±HH:mm], en fonction de timeSpec() de QDateTime. Si timeSpec() est Qt::UTC, Z sera ajouté à la chaîne ; si timeSpec() est Qt::OffsetFromUTC, le décalage en heures et en minutes par rapport à l'UTC sera ajouté à la chaîne. Pour inclure les millisecondes dans la date ISO 8601, utilisez format Qt::ISODateWithMs , qui correspond à yyyy-MM-ddTHH:mm:ss.zzz[Z|±H:mm].

Si format est Qt::RFC2822Date, la chaîne est formatée conformément à la RFC 2822.

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

Voir aussi fromString(), QDate::toString(), QTime::toString(), et QLocale::toString().

QString QDateTime::toString(const QString &format) const

QDateTime QDateTime::toTimeZone(const QTimeZone &timeZone) const

Renvoie une copie de cette date convertie au format timeZone.

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

Le résultat décrit l'instant en termes de représentation temporelle de timeZone. Par exemple :

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

Si timeZone est invalide, l'heure de la date sera invalide. Dans le cas contraire, la date renvoyée par timeSpec() correspondra à timeZone.timeSpec().

Voir aussi timeRepresentation(), toLocalTime(), toUTC(), et toOffsetFromUtc().

QDateTime QDateTime::toUTC() const

Renvoie une copie de cette date convertie en UTC.

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

Exemple :

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

Voir aussi toTimeZone(), toLocalTime() et toOffsetFromUtc().

[since 6.4] QDateTime &QDateTime::operator+=(std::chrono::milliseconds duration)

Modifie cet objet datetime en y ajoutant la valeur donnée duration. L'objet mis à jour sera plus tardif si duration est positif, ou plus précoce s'il est négatif.

Si cette date n'est pas valide, cette fonction n'a aucun effet.

Renvoie une référence à cet objet datetime.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi addMSecs().

[since 6.4] QDateTime &QDateTime::operator-=(std::chrono::milliseconds duration)

Modifie cet objet datetime en soustrayant la valeur donnée duration. L'objet mis à jour sera antérieur si duration est positif, ou postérieur s'il est négatif.

Si cette date n'est pas valide, cette fonction n'a aucun effet.

Renvoie une référence à cet objet datetime.

Cette fonction a été introduite dans Qt 6.4.

Voir aussi addMSecs.

[noexcept] QDateTime &QDateTime::operator=(const QDateTime &other)

Copie la date other dans this et renvoie cette copie.