En esta página

QDateTimeAxis Class

El QDateTimeAxis permite añadir valores de DateTime al eje de un gráfico. Más información ...

Encabezado: #include <QDateTimeAxis>
CMake: find_package(Qt6 REQUIRED COMPONENTS Graphs)
target_link_libraries(mytarget PRIVATE Qt6::Graphs)
qmake: QT += graphs
En QML: DateTimeAxis
Heredan de: QAbstractAxis

Propiedades

Funciones públicas

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

Señales

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)

Descripción detallada

Se puede utilizar un eje DateTime para mostrar representaciones de DateTime con marcas de graduación y líneas de cuadrícula. Los elementos DateTime del eje se muestran en la posición de las marcas de graduación.

Documentación de propiedades

labelFormat : QString

Esta propiedad define el formato de las etiquetas DateTime en el eje. La propiedad «format» permite especificar la representación visual del objeto DateTime en días, meses y años. El valor por defecto es dd-MMMM-yy.

Funciones de acceso:

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

Señal de notificación:

void labelFormatChanged(const QString &format)

max : QDateTime

Esta propiedad contiene el valor máximo del eje

Este valor puede ser inferior o superior al mínimo. El DateTime se almacena internamente en formato UTC. El valor por defecto es new Date(1980,1,1)

Funciones de acceso:

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

Señal de notificación:

void maxChanged(const QDateTime &max)

min : QDateTime

Esta propiedad contiene el valor mínimo del eje

Este valor puede ser inferior o superior al máximo. El tipo DateTime se almacena internamente en UTC. El valor por defecto es new Date(1970,1,1)

Funciones de acceso:

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

Señal de notificación:

void minChanged(const QDateTime &min)

[since 6.11] pan : qreal

Esta propiedad almacena el valor de desplazamiento horizontal del eje.

El valor «pan» desplaza el centro del eje sin afectar a los intervalos de la cuadrícula ni a las etiquetas. El valor por defecto es 0.

Esta enumeración se introdujo en Qt 6.11.

Funciones de acceso:

qreal pan() const
void setPan(qreal pan)

Señal del notificador:

void panChanged(qreal newPan)

subTickCount : int

Esta propiedad contiene el número de subdivisiones del eje. Indica cuántas subdivisiones se dibujan entre las líneas principales del gráfico. No se dibujan etiquetas para las subdivisiones. El valor por defecto es 0.

Funciones de acceso:

int subTickCount() const
void setSubTickCount(int newSubTickCount)

Señal de notificación:

void subTickCountChanged()

[since 6.12] tickCount : qsizetype

Esta propiedad determina el número de marcas principales que se colocan en un eje. Si el valor es 0 o inferior, el eje calcula automáticamente el número adecuado de marcas. El valor por defecto es 0.

Esta enumeración se introdujo en Qt 6.12.

Funciones de acceso:

qsizetype tickCount() const
void setTickCount(qsizetype count)

Señal de notificador:

void tickCountChanged(qsizetype count)

[until 6.15] tickInterval : qreal

Está previsto que esta enumeración quede obsoleta en la versión 6.15.

Esta propiedad indica el número de marcas principales que se colocan en un eje. Si el valor es 0 o inferior, el eje calculará automáticamente el número adecuado de marcas. El valor por defecto es 0. Utiliza en su lugar tickCount.

Funciones de acceso:

qreal tickInterval() const
void setTickInterval(qreal newTickInterval)

Señal de notificador:

void tickIntervalChanged()

[since 6.11] timeZone : QTimeZone

Esta propiedad contiene la zona horaria que se utilizará para mostrar las etiquetas de los ejes. Los valores admitidos se basan en los identificadores de zonas horarias de la IANA. La zona horaria por defecto es UTC.

Esta enumeración se introdujo en Qt 6.11.

Funciones de acceso:

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

Señal de notificación:

void timeZoneChanged(const QTimeZone &newTimeZone)

[read-only, since 6.11] visualMax : QDateTime

Esta propiedad contiene el valor máximo visual del eje.

Esta propiedad contiene el valor máximo visual del eje cuando se ha desplazado o ampliado el eje. El valor por defecto es QDateTimeAxis::max

Esta enumeración se introdujo en Qt 6.11.

Funciones de acceso:

QDateTime visualMax() const

Señal de notificador:

void visualMaxChanged(const QDateTime &newMax)

[read-only, since 6.11] visualMin : QDateTime

Esta propiedad contiene el valor mínimo visual del eje.

Esta propiedad contiene un valor mínimo visual del eje cuando se ha desplazado o ampliado el eje. El valor por defecto es QDateTimeAxis::min

Esta enumeración se introdujo en Qt 6.11.

Funciones de acceso:

QDateTime visualMin() const

Señal de notificador:

void visualMinChanged(const QDateTime &newMin)

[since 6.11] zoom : qreal

Esta propiedad contiene el valor de zoom del eje. El valor de zoom amplía o reduce el eje y, por lo tanto, el gráfico, sin afectar a los intervalos de la cuadrícula ni a las etiquetas. El valor por defecto es 1.

Esta enumeración se introdujo en Qt 6.11.

Funciones de acceso:

qreal zoom() const
void setZoom(qreal zoom)

Señal de notificación:

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.