Back to Qt.io
Contact Us Blog Download Qt
En esta página

QDateTimeAxis Class

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

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

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

QDateTimeAxis puede ser configurado para mostrar una línea de eje con marcas de tick, líneas de cuadrícula y sombras. Las etiquetas pueden configurarse estableciendo un formato DateTime apropiado. QDateTimeAxis funciona correctamente con fechas desde 4714 BCE hasta 287396 CE. Para otras limitaciones relacionadas con QDateTime, consulte la documentación de QDateTime.

Nota: QDateTimeAxis esta deshabilitado en plataformas que definen qreal como float.

Recorte de pantalla que muestra el eje x que describe las horas de las fechas

QDateTimeAxis puede utilizarse 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 la adición de la serie al gráfico y la configuración 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);

Documentación de Propiedades

format : QString

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

Consulte 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 del notificador:

void formatChanged(QString format)

Véase también QChart::locale.

max : QDateTime

Esta propiedad contiene el valor máximo del eje.

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

Funciones de acceso:

QDateTime max() const
void setMax(QDateTime max)

Señal del notificador:

void maxChanged(QDateTime max)

min : QDateTime

Esta propiedad contiene el valor mínimo del eje.

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

Funciones de acceso:

QDateTime min() const
void setMin(QDateTime min)

Señal del notificador:

void minChanged(QDateTime min)

tickCount : int

Esta propiedad contiene el número de marcas de graduación del eje.

Funciones de acceso:

int tickCount() const
void setTickCount(int count)

Señal del notificador:

void tickCountChanged(int tickCount)

Documentación de funciones miembro

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

Construye un objeto eje hijo de parent.

[virtual noexcept] QDateTimeAxis::~QDateTimeAxis()

Destruye el objeto.

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

Esta señal se emite cuando cambia la dirección format del eje.

Nota: Señal notificadora para la propiedad format.

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

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

Nota: Señal notificadora de la propiedad max.

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

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

Nota: Señal notificadora de 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 por min y max.

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

Establece el rango en el eje de min a max. Si min es mayor que max, esta función vuelve sin realizar ningún cambio.

void QDateTimeAxis::setTickCount(int count)

Establece el número de marcas de graduación en el eje en count.

Nota: Función Setter para la propiedad tickCount.

Véase también tickCount().

int QDateTimeAxis::tickCount() const

Devuelve el número de marcas de graduación en el eje.

Nota: Función Getter 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 graduación en el eje, especificado por tickCount.

Nota: Señal notificadora 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.