Back to Qt.io
Contact Us Blog Download Qt
Sur cette page

QDateTimeAxis Class

La classe QDateTimeAxis ajoute des dates et des heures à l'axe d'un graphique. En savoir plus...

Header: #include <QDateTimeAxis>
In QML: DateTimeAxis
Inherits: QAbstractAxis
Status: Deprecated

Cette classe est obsolète. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Propriétés

Fonctions publiques

QDateTimeAxis(QObject *parent = nullptr)
virtual ~QDateTimeAxis()
QString format() const
QDateTime max() const
QDateTime min() const
void setFormat(QString format)
void setMax(QDateTime max)
void setMin(QDateTime min)
void setRange(QDateTime min, QDateTime max)
void setTickCount(int count)
int tickCount() const

Fonctions publiques réimplémentées

virtual QAbstractAxis::AxisType type() const override

Signaux

void formatChanged(QString format)
void maxChanged(QDateTime max)
void minChanged(QDateTime min)
void rangeChanged(QDateTime min, QDateTime max)
void tickCountChanged(int tickCount)

Description détaillée

QDateTimeAxis peut être configuré pour afficher une ligne d’axe avec des repères, des lignes de grille et des ombres. Les libellés peuvent être configurés en définissant un format DateTime approprié. QDateTimeAxis fonctionne correctement avec des dates comprises entre 4714 av. J.-C. et 287396 apr. J.-C. Pour connaître les autres limitations liées à QDateTime, consultez la documentation de QDateTime.

Remarque : QDateTimeAxis est désactivé sur les plateformes qui définissent `qreal` comme un type `float`.

Extrait de capture d'écran montrant l'axe des x représentant les dates et heures

QDateTimeAxis peut être utilisé avec n’importe quelle instance de ` QXYSeries`. Pour ajouter un point de données à la série, on utilise ` QDateTime::toMSecsSinceEpoch()` :

QLineSeries *series = new QLineSeries;

QDateTime xValue;
xValue.setDate(QDate(2012, 1 , 18));
xValue.setTime(QTime(9, 34));
qreal yValue = 12;
series->append(xValue.toMSecsSinceEpoch(), yValue);

xValue.setDate(QDate(2013, 5 , 11));
xValue.setTime(QTime(11, 14));
qreal yValue = 22;
series->append(xValue.toMSecsSinceEpoch(), yValue);

L'extrait de code suivant illustre l'ajout de la série au graphique et la configuration de QDateTimeAxis :

QChartView *chartView = new QChartView;
chartView->chart()->addSeries(series);

// ...
QDateTimeAxis *axisX = new QDateTimeAxis;
axisX->setFormat("dd-MM-yyyy h:mm");
chartView->chart()->setAxisX(axisX, series);

Documentation des propriétés

format : QString

Cette propriété contient la chaîne de format utilisée lors de la création de l'étiquette de l'axe à partir d'un objet ` QDateTime `.

Consultez la documentation d'QDateTime pour savoir comment définir cette chaîne.

Fonctions d'accès :

QString format() const
void setFormat(QString format)

Signal de notification :

void formatChanged(QString format)

Voir également QChart::locale.

max : QDateTime

Cette propriété contient la valeur maximale de l'axe.

Lors de la définition de cette propriété, la valeur minimale est ajustée si nécessaire, afin de garantir que la plage reste valide.

Fonctions d'accès :

QDateTime max() const
void setMax(QDateTime max)

Signal de notification :

void maxChanged(QDateTime max)

min : QDateTime

Cette propriété contient la valeur minimale de l'axe.

Lors de la définition de cette propriété, la valeur maximale est ajustée si nécessaire, afin de garantir que la plage reste valide.

Fonctions d’accès :

QDateTime min() const
void setMin(QDateTime min)

Signal de notification :

void minChanged(QDateTime min)

tickCount : int

Cette propriété définit le nombre de graduations sur l'axe.

Fonctions d'accès :

int tickCount() const
void setTickCount(int count)

Signal de notification :

void tickCountChanged(int tickCount)

Documentation des fonctions membres

[explicit] QDateTimeAxis::QDateTimeAxis(QObject *parent = nullptr)

Crée un objet « axe » qui est un enfant de parent.

[virtual noexcept] QDateTimeAxis::~QDateTimeAxis()

Détruit l'objet.

[signal] void QDateTimeAxis::formatChanged(QString format)

Ce signal est émis lorsque l'format de l'axe change.

Remarque : signalde notification pour la propriété « format ».

[signal] void QDateTimeAxis::maxChanged(QDateTime max)

Ce signal est émis lorsque la valeur maximale de l'axe, spécifiée par max, change.

Remarque : signalde notification pour la propriété max.

[signal] void QDateTimeAxis::minChanged(QDateTime min)

Ce signal est émis lorsque la valeur minimale de l'axe, spécifiée par min, change.

Remarque : signalde notification pour la propriété min.

[signal] void QDateTimeAxis::rangeChanged(QDateTime min, QDateTime max)

Ce signal est émis lorsque la valeur minimale ou maximale de l'axe, définie par min et max, change.

void QDateTimeAxis::setRange(QDateTime min, QDateTime max)

Définit l'intervalle de l'axe de min à max. Si min est supérieur à max, cette fonction se termine sans effectuer de modification.

void QDateTimeAxis::setTickCount(int count)

Définit le nombre de graduations sur l'axe à count.

Remarque : fonctionde définition de la propriété tickCount.

Voir également ` tickCount()`.

int QDateTimeAxis::tickCount() const

Renvoie le nombre de graduations sur l'axe.

Remarque : fonctiongetter pour la propriété tickCount.

Voir aussi setTickCount().

[signal] void QDateTimeAxis::tickCountChanged(int tickCount)

Ce signal est émis lorsque le nombre de graduations sur l'axe, spécifié par tickCount, change.

Remarque : signalde notification pour la propriété tickCount.

[override virtual] QAbstractAxis::AxisType QDateTimeAxis::type() const

Réimplémente : ` QAbstractAxis::type()` const.

Renvoie le type de l'axe.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.