QDateTimeAxis

The QDateTimeAxis class adds dates and times to a chart’s axis. More

Inheritance diagram of PySide6.QtCharts.QDateTimeAxis

Synopsis

Functions

Detailed Description

QDateTimeAxis can be set up to show an axis line with tick marks, grid lines, and shades. The labels can be configured by setting an appropriate DateTime format. QDateTimeAxis works correctly with dates from 4714 BCE to 287396 CE. For other limitiations related to QDateTime , see QDateTime documentation.

Note

QDateTimeAxis is disabled on platforms that define qreal as float.

../../_images/api_datatime_axis.png

QDateTimeAxis can be used with any QXYSeries . To add a data point to the series, toMSecsSinceEpoch() is used:

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);

The following code snippet illustrates adding the series to the chart and setting up 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);
class PySide6.QtCharts.QDateTimeAxis([parent=None])
Parameters

parentPySide6.QtCore.QObject

Constructs an axis object that is a child of parent.

PySide6.QtCharts.QDateTimeAxis.format()
Return type

str

See also

setFormat()

PySide6.QtCharts.QDateTimeAxis.formatChanged(format)
Parameters

format – str

PySide6.QtCharts.QDateTimeAxis.max()
Return type

PySide6.QtCore.QDateTime

See also

setMax()

PySide6.QtCharts.QDateTimeAxis.maxChanged(max)
Parameters

maxPySide6.QtCore.QDateTime

PySide6.QtCharts.QDateTimeAxis.min()
Return type

PySide6.QtCore.QDateTime

See also

setMin()

PySide6.QtCharts.QDateTimeAxis.minChanged(min)
Parameters

minPySide6.QtCore.QDateTime

PySide6.QtCharts.QDateTimeAxis.rangeChanged(min, max)
Parameters
PySide6.QtCharts.QDateTimeAxis.setFormat(format)
Parameters

format – str

See also

format()

PySide6.QtCharts.QDateTimeAxis.setMax(max)
Parameters

maxPySide6.QtCore.QDateTime

See also

max()

PySide6.QtCharts.QDateTimeAxis.setMin(min)
Parameters

minPySide6.QtCore.QDateTime

See also

min()

PySide6.QtCharts.QDateTimeAxis.setRange(min, max)
Parameters

Sets the range on the axis from min to max. If min is greater than max, this function returns without making any changes.

PySide6.QtCharts.QDateTimeAxis.setTickCount(count)
Parameters

count – int

Sets the number of tick marks on the axis to count.

See also

tickCount()

PySide6.QtCharts.QDateTimeAxis.tickCount()
Return type

int

See also

setTickCount()

PySide6.QtCharts.QDateTimeAxis.tickCountChanged(tick)
Parameters

tick – int