Sur cette page

QDateTimeAxis Class

L'axe QDateTimeAxis permet d'ajouter des valeurs DateTime à l'axe d'un graphique. En savoir plus...

En-tête : #include <QDateTimeAxis>
CMake : find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake : QT += graphs
En QML : DateTimeAxis
Hérite de : QAbstractAxis

Propriétés

Fonctions publiques

QString labelFormat() const
QDateTime max() const
QDateTime min() const
qreal pan() const
void setLabelFormat(const QString &format)
void setMax(const QDateTime &max)
void setMin(const QDateTime &min)
void setPan(qreal pan)
void setSubTickCount(int newSubTickCount)
void setTickCount(qsizetype count)
void setTickInterval(qreal newTickInterval)
void setTimeZone(const QTimeZone &zoneId)
void setZoom(qreal zoom)
int subTickCount() const
qsizetype tickCount() const
qreal tickInterval() const
QTimeZone timeZone() const
QDateTime visualMax() const
QDateTime visualMin() const
qreal zoom() const

Signaux

void labelFormatChanged(const QString &format)
void maxChanged(const QDateTime &max)
void minChanged(const QDateTime &min)
void panChanged(qreal newPan)
void subTickCountChanged()
void tickCountChanged(qsizetype count)
void tickIntervalChanged()
void timeZoneChanged(const QTimeZone &newTimeZone)
void visualMaxChanged(const QDateTime &newMax)
void visualMinChanged(const QDateTime &newMin)
void zoomChanged(qreal newZoom)

Description détaillée

Un axe DateTime permet d'afficher des représentations DateTime avec des repères et des lignes de quadrillage. Les éléments DateTime sur l'axe sont affichés à la position des repères.

Documentation des propriétés

labelFormat : QString

Cette propriété définit le format des étiquettes DateTime sur l'axe. La propriété « format » permet de spécifier la représentation visuelle de l'objet DateTime, en jours, mois et années. La valeur par défaut est « dd-MMMM-yy ».

Fonctions d'accès :

QString labelFormat() const
void setLabelFormat(const QString &format)

Signal de notification :

void labelFormatChanged(const QString &format)

max : QDateTime

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

Cette valeur peut être inférieure ou supérieure au minimum. La date-heure est stockée en UTC en interne. La valeur par défaut est new Date(1980,1,1)

Fonctions d'accès :

QDateTime max() const
void setMax(const QDateTime &max)

Signal de notification :

void maxChanged(const QDateTime &max)

min : QDateTime

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

Cette valeur peut être inférieure ou supérieure à la valeur maximale. Le type DateTime est stocké en interne au format UTC. La valeur par défaut est new Date(1970,1,1)

Fonctions d'accès :

QDateTime min() const
void setMin(const QDateTime &min)

Signal de notification :

void minChanged(const QDateTime &min)

[since 6.11] pan : qreal

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

La valeur « pan » déplace le centre de l'axe sans affecter les intervalles de la grille ni les libellés. La valeur par défaut est 0.

Cette énumération a été introduite dans Qt 6.11.

Fonctions d'accès :

qreal pan() const
void setPan(qreal pan)

Signal de notification :

void panChanged(qreal newPan)

subTickCount : int

Cette propriété contient le nombre de sous-graduations sur l'axe. Elle indique le nombre de sous-graduations tracées entre les lignes principales du graphique. Aucune étiquette n'est affichée pour les sous-graduations. La valeur par défaut est 0.

Fonctions d'accès :

int subTickCount() const
void setSubTickCount(int newSubTickCount)

Signal de notification :

void subTickCountChanged()

[since 6.12] tickCount : qsizetype

Cette propriété détermine le nombre de graduations principales affichées sur un axe. Si la valeur est égale à 0 ou inférieure, l'axe calcule automatiquement le nombre approprié de graduations. La valeur par défaut est 0.

Cette énumération a été introduite dans Qt 6.12.

Fonctions d’accès :

qsizetype tickCount() const
void setTickCount(qsizetype count)

Signal de notification :

void tickCountChanged(qsizetype count)

[until 6.15] tickInterval : qreal

Cette énumération est prévue pour être obsolète à partir de la version 6.15.

Cette propriété indique le nombre de graduations principales placées sur un axe. Si la valeur est égale à 0 ou inférieure, l'axe calculera automatiquement le nombre approprié de graduations. La valeur par défaut est 0. Utilisez plutôt tickCount.

Fonctions d'accès :

qreal tickInterval() const
void setTickInterval(qreal newTickInterval)

Signal de notification :

void tickIntervalChanged()

[since 6.11] timeZone : QTimeZone

Cette propriété définit le fuseau horaire qui sera utilisé pour afficher les libellés des axes. Les valeurs acceptées correspondent aux identifiants de fuseaux horaires de l'IANA. Le fuseau horaire par défaut est UTC.

Cette énumération a été introduite dans Qt 6.11.

Fonctions d'accès :

QTimeZone timeZone() const
void setTimeZone(const QTimeZone &zoneId)

Signal de notification :

void timeZoneChanged(const QTimeZone &newTimeZone)

[read-only, since 6.11] visualMax : QDateTime

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

Cette propriété contient la valeur maximale visuelle de l'axe lorsque celui-ci a fait l'objet d'un panoramique ou d'un zoom. La valeur par défaut est QDateTimeAxis::max

Cette énumération a été introduite dans Qt 6.11.

Fonctions d'accès :

QDateTime visualMax() const

Signal de notification :

void visualMaxChanged(const QDateTime &newMax)

[read-only, since 6.11] visualMin : QDateTime

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

Cette propriété contient la valeur minimale visuelle de l'axe lorsque celui-ci a fait l'objet d'un panoramique ou d'un zoom. La valeur par défaut est QDateTimeAxis::min

Cette énumération a été introduite dans Qt 6.11.

Fonctions d'accès :

QDateTime visualMin() const

Signal de notification :

void visualMinChanged(const QDateTime &newMin)

[since 6.11] zoom : qreal

Cette propriété contient la valeur de zoom de l'axe. La valeur de zoom agrandit ou réduit l'axe, et donc le graphique, sans modifier les intervalles de la grille ni les étiquettes. La valeur par défaut est 1.

Cette énumération a été introduite dans Qt 6.11.

Fonctions d'accès :

qreal zoom() const
void setZoom(qreal zoom)

Signal de notification :

void zoomChanged(qreal newZoom)

© 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.