En esta página

QDateTimeAxis Class

La clase QDateTimeAxis añade fechas y horas al eje de un gráfico. Más información...

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

Esta clase está obsoleta. Recomendamos encarecidamente no utilizarla en código nuevo.

Propiedades

Funciones públicas

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

Funciones públicas reimplementadas

virtual QAbstractAxis::AxisType type() const override

Señales

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

Descripción detallada

QDateTime se puede configurar para mostrar una línea de eje con marcas de graduación, líneas de cuadrícula y sombreados. Las etiquetas se pueden configurar estableciendo un formato DateTime adecuado. funciona correctamente con fechas comprendidas entre el 4714 a. C. y el 287396 d. C. Para conocer otras limitaciones relacionadas con , consulta la documentación de QDateTime.

Nota: QDateTimeAxis está desactivado en plataformas que definen `qreal` como `float`.

Recorte de una captura de pantalla en el que se ve el eje X, que indica las fechas y horas

QDateTimeAxis se puede utilizar con cualquier QXYSeries. Para añadir un punto de datos a la serie, se utiliza 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);

El siguiente fragmento de código ilustra cómo añadir la serie al gráfico y configurar 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);

Documentación de propiedades

format : QString

Esta propiedad contiene la cadena de formato que se utiliza al crear la etiqueta del eje a partir de un objeto QDateTime.

Consulta la documentación de « QDateTime » para obtener información sobre cómo debe definirse la cadena.

Funciones de acceso:

QString format() const
void setFormat(QString format)

Señal de notificación:

void formatChanged(QString format)

Véase también « QChart::locale ».

max : QDateTime

Esta propiedad indica el valor máximo del eje.

Al configurar esta propiedad, el valor mínimo se ajusta si es necesario, para garantizar que el rango siga siendo válido.

Funciones de acceso:

QDateTime max() const
void setMax(QDateTime max)

Señal de notificación:

void maxChanged(QDateTime max)

min : QDateTime

Esta propiedad contiene el valor mínimo del eje.

Al configurar esta propiedad, el valor máximo se ajusta, si es necesario, para garantizar que el rango siga siendo válido.

Funciones de acceso:

QDateTime min() const
void setMin(QDateTime min)

Señal de notificación:

void minChanged(QDateTime min)

tickCount : int

Esta propiedad indica el número de marcas de escala del eje.

Funciones de acceso:

int tickCount() const
void setTickCount(int count)

Señal de notificación:

void tickCountChanged(int tickCount)

Documentación de funciones de miembro

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

Crea un objeto de eje que es un elemento secundario de parent.

[virtual noexcept] QDateTimeAxis::~QDateTimeAxis()

Destruye el objeto.

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

Esta señal se emite cuando cambia el valor de la propiedad « format » del eje.

Nota: Señalde notificación para la propiedad « format ».

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

Esta señal se emite cuando cambia el valor máximo del eje, especificado por max.

Nota: Señalde notificación para la propiedad max.

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

Esta señal se emite cuando cambia el valor mínimo del eje, especificado por min.

Nota: Señalde notificación para la propiedad min.

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

Esta señal se emite cuando cambia el valor mínimo o máximo del eje, especificado en min y max.

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

Establece el intervalo del eje desde min hasta max. Si min es mayor que max, esta función finaliza sin realizar ningún cambio.

void QDateTimeAxis::setTickCount(int count)

Establece el número de marcas de escala en el eje en count.

Nota: Funciónde configuración para la propiedad tickCount.

Véase también ` tickCount()`.

int QDateTimeAxis::tickCount() const

Devuelve el número de marcas de escala del eje.

Nota: Funcióngetter para la propiedad tickCount.

Véase también setTickCount().

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

Esta señal se emite cuando cambia el número de marcas de escala en el eje, especificado por ` tickCount`.

Nota: Señalde notificación para la propiedad tickCount.

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

Reimplementa: ` QAbstractAxis::type()` const.

Devuelve el tipo del eje.

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