Specialized axis ticker for calendar dates and times as axis ticks. More...

#include <qcustomplot.h>

Inheritance diagram for QCPAxisTickerDateTime:

Public Member Functions
	QCPAxisTickerDateTime ()

QString	dateTimeFormat () const

Qt::TimeSpec	dateTimeSpec () const

void	setDateTimeFormat (const QString &format)

void	setDateTimeSpec (Qt::TimeSpec spec)

void	setTickOrigin (double origin)

void	setTickOrigin (const QDateTime &origin)

	QCPAxisTickerDateTime ()

QString	dateTimeFormat () const

Qt::TimeSpec	dateTimeSpec () const

void	setDateTimeFormat (const QString &format)

void	setDateTimeSpec (Qt::TimeSpec spec)

void	setTickOrigin (double origin)

void	setTickOrigin (const QDateTime &origin)

	QCPAxisTickerDateTime ()

QString	dateTimeFormat () const

Qt::TimeSpec	dateTimeSpec () const

void	setDateTimeFormat (const QString &format)

void	setDateTimeSpec (Qt::TimeSpec spec)

void	setTickOrigin (double origin)

void	setTickOrigin (const QDateTime &origin)

	QCPAxisTickerDateTime ()

QString	dateTimeFormat () const

Qt::TimeSpec	dateTimeSpec () const

void	setDateTimeFormat (const QString &format)

void	setDateTimeSpec (Qt::TimeSpec spec)

void	setTickOrigin (double origin)

void	setTickOrigin (const QDateTime &origin)

	QCPAxisTickerDateTime ()

QString	dateTimeFormat () const

Qt::TimeSpec	dateTimeSpec () const

void	setDateTimeFormat (const QString &format)

void	setDateTimeSpec (Qt::TimeSpec spec)

void	setTickOrigin (double origin)

void	setTickOrigin (const QDateTime &origin)

Public Member Functions inherited from QCPAxisTicker
	QCPAxisTicker ()

virtual	~QCPAxisTicker ()

TickStepStrategy	tickStepStrategy () const

int	tickCount () const

double	tickOrigin () const

void	setTickStepStrategy (TickStepStrategy strategy)

void	setTickCount (int count)

void	setTickOrigin (double origin)

virtual void	generate (const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector< double > &ticks, QVector< double > subTicks, QVector< QString > tickLabels)

	QCPAxisTicker ()

virtual	~QCPAxisTicker ()

TickStepStrategy	tickStepStrategy () const

int	tickCount () const

double	tickOrigin () const

void	setTickStepStrategy (TickStepStrategy strategy)

void	setTickCount (int count)

void	setTickOrigin (double origin)

virtual void	generate (const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector< double > &ticks, QVector< double > subTicks, QVector< QString > tickLabels)

	QCPAxisTicker ()

virtual	~QCPAxisTicker ()

TickStepStrategy	tickStepStrategy () const

int	tickCount () const

double	tickOrigin () const

void	setTickStepStrategy (TickStepStrategy strategy)

void	setTickCount (int count)

void	setTickOrigin (double origin)

virtual void	generate (const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector< double > &ticks, QVector< double > subTicks, QVector< QString > tickLabels)

	QCPAxisTicker ()

virtual	~QCPAxisTicker ()

TickStepStrategy	tickStepStrategy () const

int	tickCount () const

double	tickOrigin () const

void	setTickStepStrategy (TickStepStrategy strategy)

void	setTickCount (int count)

void	setTickOrigin (double origin)

virtual void	generate (const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector< double > &ticks, QVector< double > subTicks, QVector< QString > tickLabels)

	QCPAxisTicker ()

virtual	~QCPAxisTicker ()

TickStepStrategy	tickStepStrategy () const

int	tickCount () const

double	tickOrigin () const

void	setTickStepStrategy (TickStepStrategy strategy)

void	setTickCount (int count)

void	setTickOrigin (double origin)

virtual void	generate (const QCPRange &range, const QLocale &locale, QChar formatChar, int precision, QVector< double > &ticks, QVector< double > subTicks, QVector< QString > tickLabels)

Static Public Member Functions
static QDateTime	keyToDateTime (double key)

static double	dateTimeToKey (const QDateTime dateTime)

static double	dateTimeToKey (const QDate date)

static QDateTime	keyToDateTime (double key)

static double	dateTimeToKey (const QDateTime dateTime)

static double	dateTimeToKey (const QDate date)

static QDateTime	keyToDateTime (double key)

static double	dateTimeToKey (const QDateTime dateTime)

static double	dateTimeToKey (const QDate date)

static QDateTime	keyToDateTime (double key)

static double	dateTimeToKey (const QDateTime dateTime)

static double	dateTimeToKey (const QDate date)

static QDateTime	keyToDateTime (double key)

static double	dateTimeToKey (const QDateTime dateTime)

static double	dateTimeToKey (const QDate date)

Protected Types
enum	DateStrategy { dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth }

enum	DateStrategy { dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth }

enum	DateStrategy { dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth }

enum	DateStrategy { dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth }

enum	DateStrategy { dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth, dsNone, dsUniformTimeInDay, dsUniformDayInMonth }

Protected Member Functions
virtual double	getTickStep (const QCPRange &range) Q_DECL_OVERRIDE

virtual int	getSubTickCount (double tickStep) Q_DECL_OVERRIDE

virtual QString	getTickLabel (double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE

virtual QVector< double >	createTickVector (double tickStep, const QCPRange &range) Q_DECL_OVERRIDE

virtual double	getTickStep (const QCPRange &range) Q_DECL_OVERRIDE

virtual int	getSubTickCount (double tickStep) Q_DECL_OVERRIDE

virtual QString	getTickLabel (double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE

virtual QVector< double >	createTickVector (double tickStep, const QCPRange &range) Q_DECL_OVERRIDE

virtual double	getTickStep (const QCPRange &range) Q_DECL_OVERRIDE

virtual int	getSubTickCount (double tickStep) Q_DECL_OVERRIDE

virtual QString	getTickLabel (double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE

virtual QVector< double >	createTickVector (double tickStep, const QCPRange &range) Q_DECL_OVERRIDE

virtual double	getTickStep (const QCPRange &range) Q_DECL_OVERRIDE

virtual int	getSubTickCount (double tickStep) Q_DECL_OVERRIDE

virtual QString	getTickLabel (double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE

virtual QVector< double >	createTickVector (double tickStep, const QCPRange &range) Q_DECL_OVERRIDE

virtual double	getTickStep (const QCPRange &range) Q_DECL_OVERRIDE

virtual int	getSubTickCount (double tickStep) Q_DECL_OVERRIDE

virtual QString	getTickLabel (double tick, const QLocale &locale, QChar formatChar, int precision) Q_DECL_OVERRIDE

virtual QVector< double >	createTickVector (double tickStep, const QCPRange &range) Q_DECL_OVERRIDE

Protected Member Functions inherited from QCPAxisTicker
virtual QVector< double >	createSubTickVector (int subTickCount, const QVector< double > &ticks)

virtual QVector< QString >	createLabelVector (const QVector< double > &ticks, const QLocale &locale, QChar formatChar, int precision)

void	trimTicks (const QCPRange &range, QVector< double > &ticks, bool keepOneOutlier) const

double	pickClosest (double target, const QVector< double > &candidates) const

double	getMantissa (double input, double *magnitude=0) const

double	cleanMantissa (double input) const

virtual QVector< double >	createSubTickVector (int subTickCount, const QVector< double > &ticks)

virtual QVector< QString >	createLabelVector (const QVector< double > &ticks, const QLocale &locale, QChar formatChar, int precision)

void	trimTicks (const QCPRange &range, QVector< double > &ticks, bool keepOneOutlier) const

double	pickClosest (double target, const QVector< double > &candidates) const

double	getMantissa (double input, double *magnitude=0) const

double	cleanMantissa (double input) const

virtual QVector< double >	createSubTickVector (int subTickCount, const QVector< double > &ticks)

virtual QVector< QString >	createLabelVector (const QVector< double > &ticks, const QLocale &locale, QChar formatChar, int precision)

void	trimTicks (const QCPRange &range, QVector< double > &ticks, bool keepOneOutlier) const

double	pickClosest (double target, const QVector< double > &candidates) const

double	getMantissa (double input, double *magnitude=0) const

double	cleanMantissa (double input) const

virtual QVector< double >	createSubTickVector (int subTickCount, const QVector< double > &ticks)

virtual QVector< QString >	createLabelVector (const QVector< double > &ticks, const QLocale &locale, QChar formatChar, int precision)

void	trimTicks (const QCPRange &range, QVector< double > &ticks, bool keepOneOutlier) const

double	pickClosest (double target, const QVector< double > &candidates) const

double	getMantissa (double input, double *magnitude=0) const

double	cleanMantissa (double input) const

virtual QVector< double >	createSubTickVector (int subTickCount, const QVector< double > &ticks)

virtual QVector< QString >	createLabelVector (const QVector< double > &ticks, const QLocale &locale, QChar formatChar, int precision)

void	trimTicks (const QCPRange &range, QVector< double > &ticks, bool keepOneOutlier) const

double	pickClosest (double target, const QVector< double > &candidates) const

double	getMantissa (double input, double *magnitude=0) const

double	cleanMantissa (double input) const

Protected Attributes
QString	mDateTimeFormat

Qt::TimeSpec	mDateTimeSpec

enum QCPAxisTickerDateTime::DateStrategy	mDateStrategy

Protected Attributes inherited from QCPAxisTicker
TickStepStrategy	mTickStepStrategy

int	mTickCount

double	mTickOrigin

Additional Inherited Members
Public Types inherited from QCPAxisTicker
enum	TickStepStrategy { tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount }

enum	TickStepStrategy { tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount }

enum	TickStepStrategy { tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount }

enum	TickStepStrategy { tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount }

enum	TickStepStrategy { tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount, tssReadability, tssMeetTickCount }

Detailed Description

Specialized axis ticker for calendar dates and times as axis ticks.

This QCPAxisTicker subclass generates ticks that correspond to real calendar dates and times. The plot axis coordinate is interpreted as Unix Time, so seconds since Epoch (January 1, 1970, 00:00 UTC). This is also used for example by QDateTime in the toTime_t()/setTime_t() methods with a precision of one second. Since Qt 4.7, millisecond accuracy can be obtained from QDateTime by using QDateTime::fromMSecsSinceEpoch()/1000.0. The static methods dateTimeToKey and keyToDateTime conveniently perform this conversion achieving a precision of one millisecond on all Qt versions.

The format of the date/time display in the tick labels is controlled with setDateTimeFormat. If a different time spec (time zone) shall be used, see setDateTimeSpec.

This ticker produces unequal tick spacing in order to provide intuitive date and time-of-day ticks. For example, if the axis range spans a few years such that there is one tick per year, ticks will be positioned on 1. January of every year. This is intuitive but, due to leap years, will result in slightly unequal tick intervals (visually unnoticeable). The same can be seen in the image above: even though the number of days varies month by month, this ticker generates ticks on the same day of each month.

If you would like to change the date/time that is used as a (mathematical) starting date for the ticks, use the setTickOrigin(const QDateTime &origin) method overload, which takes a QDateTime. If you pass 15. July, 9:45 to this method, the yearly ticks will end up on 15. July at 9:45 of every year.

The ticker can be created and assigned to an axis like this:

Note: If you rather wish to display relative times in terms of days, hours, minutes, seconds and milliseconds, and are not interested in the intricacies of real calendar dates with months and (leap) years, have a look at QCPAxisTickerTime instead.

Member Enumeration Documentation

enum QCPAxisTickerDateTime::DateStrategy

protected

Enumerator
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth

enum QCPAxisTickerDateTime::DateStrategy

protected

Enumerator
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth

enum QCPAxisTickerDateTime::DateStrategy

protected

Enumerator
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth

enum QCPAxisTickerDateTime::DateStrategy

protected

Enumerator
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth

enum QCPAxisTickerDateTime::DateStrategy

protected

Enumerator
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth
dsNone
dsUniformTimeInDay
dsUniformDayInMonth

Constructor & Destructor Documentation

QCPAxisTickerDateTime::QCPAxisTickerDateTime ( )

Constructs the ticker and sets reasonable default values. Axis tickers are commonly created managed by a QSharedPointer, which then can be passed to QCPAxis::setTicker.

QCPAxisTickerDateTime::QCPAxisTickerDateTime ( )

Member Function Documentation

QVector< double > QCPAxisTickerDateTime::createTickVector	(	double	tickStep,
		const QCPRange &	range
	)

protectedvirtual

Reimplemented from QCPAxisTicker.

virtual QVector<double> QCPAxisTickerDateTime::createTickVector	(	double	tickStep,
		const QCPRange &	range
	)

protectedvirtual

Reimplemented from QCPAxisTicker.

virtual QVector<double> QCPAxisTickerDateTime::createTickVector	(	double	tickStep,
		const QCPRange &	range
	)

protectedvirtual

Reimplemented from QCPAxisTicker.

virtual QVector<double> QCPAxisTickerDateTime::createTickVector	(	double	tickStep,
		const QCPRange &	range
	)

protectedvirtual

Reimplemented from QCPAxisTicker.

virtual QVector<double> QCPAxisTickerDateTime::createTickVector	(	double	tickStep,
		const QCPRange &	range
	)

protectedvirtual

Reimplemented from QCPAxisTicker.