QwtDateScaleDraw(3) Qwt User's Guide QwtDateScaleDraw(3) NAME QwtDateScaleDraw - A class for drawing datetime scales. SYNOPSIS #include Inherits QwtScaleDraw. Public Member Functions QwtDateScaleDraw (Qt::TimeSpec=Qt::LocalTime) Constructor. virtual ~QwtDateScaleDraw () Destructor. void setDateFormat (QwtDate::IntervalType, const QString &) QString dateFormat (QwtDate::IntervalType) const void setTimeSpec (Qt::TimeSpec) Qt::TimeSpec timeSpec () const void setUtcOffset (int seconds) int utcOffset () const void setWeek0Type (QwtDate::Week0Type) QwtDate::Week0Type week0Type () const virtual QwtText label (double) const override Convert a value into its representing label. QDateTime toDateTime (double) const Protected Member Functions virtual QwtDate::IntervalType intervalType (const QwtScaleDiv &) const virtual QString dateFormatOfDate (const QDateTime &, QwtDate::IntervalType) const Additional Inherited Members Detailed Description A class for drawing datetime scales. QwtDateScaleDraw displays values as datetime labels. The format of the labels depends on the alignment of the major tick labels. The default format strings are: o Millisecond 'hh:mm:ss:zzz\nddd dd MMM yyyy' o Second 'hh:mm:ss\nddd dd MMM yyyy' o Minute 'hh:mm\nddd dd MMM yyyy' o Hour 'hh:mm\nddd dd MMM yyyy' o Day 'ddd dd MMM yyyy' o Week 'Www yyyy' o Month 'MMM yyyy' o Year 'yyyy' The format strings can be modified using setDateFormat() or individually for each tick label by overloading dateFormatOfDate(), Usually QwtDateScaleDraw is used in combination with QwtDateScaleEngine, that calculates scales for datetime intervals. See also QwtDateScaleEngine, QwtPlot::setAxisScaleDraw() Definition at line 52 of file qwt_date_scale_draw.h. Constructor & Destructor Documentation QwtDateScaleDraw::QwtDateScaleDraw (Qt::TimeSpec timeSpec = Qt::LocalTime) [explicit] Constructor. The default setting is to display tick labels for the given time specification. The first week of a year is defined like for QwtDate::FirstThursday. Parameters timeSpec Time specification See also setTimeSpec(), setWeek0Type() Definition at line 48 of file qwt_date_scale_draw.cpp. Member Function Documentation QString QwtDateScaleDraw::dateFormat (QwtDate::IntervalType intervalType) const Parameters intervalType Interval type Returns Default format string for an datetime interval type See also setDateFormat(), dateFormatOfDate() Definition at line 152 of file qwt_date_scale_draw.cpp. QString QwtDateScaleDraw::dateFormatOfDate (const QDateTime & dateTime, QwtDate::IntervalType intervalType) const [protected], [virtual] Format string for the representation of a datetime dateFormatOfDate() is intended to be overloaded for situations, where formats are individual for specific datetime values. The default setting ignores dateTime and return the default format for the interval type. Parameters dateTime Datetime value intervalType Interval type Returns Format string See also setDateFormat(), QwtDate::toString() Definition at line 180 of file qwt_date_scale_draw.cpp. QwtDate::IntervalType QwtDateScaleDraw::intervalType (const QwtScaleDiv & scaleDiv) const [protected], [virtual] Find the less detailed datetime unit, where no rounding errors happen. Parameters scaleDiv Scale division Returns Interval type See also dateFormatOfDate() Definition at line 223 of file qwt_date_scale_draw.cpp. QwtText QwtDateScaleDraw::label (double value) const [override], [virtual] Convert a value into its representing label. The value is converted to a datetime value using toDateTime() and converted to a plain text using QwtDate::toString(). Parameters value Value Returns Label string. See also dateFormatOfDate() Reimplemented from QwtAbstractScaleDraw. Definition at line 205 of file qwt_date_scale_draw.cpp. void QwtDateScaleDraw::setDateFormat (QwtDate::IntervalType intervalType, const QString & format) Set the default format string for an datetime interval type Parameters intervalType Interval type format Default format string See also dateFormat(), dateFormatOfDate(), QwtDate::toString() Definition at line 137 of file qwt_date_scale_draw.cpp. void QwtDateScaleDraw::setTimeSpec (Qt::TimeSpec timeSpec) Set the time specification used for the tick labels Parameters timeSpec Time specification See also timeSpec(), setUtcOffset(), toDateTime() Definition at line 65 of file qwt_date_scale_draw.cpp. void QwtDateScaleDraw::setUtcOffset (int seconds) Set the offset in seconds from Coordinated Universal Time Parameters seconds Offset in seconds Note The offset has no effect beside for the time specification Qt::OffsetFromUTC. See also QDate::utcOffset(), setTimeSpec(), toDateTime() Definition at line 89 of file qwt_date_scale_draw.cpp. void QwtDateScaleDraw::setWeek0Type (QwtDate::Week0Type week0Type) Sets how to identify the first week of a year. Parameters week0Type Mode how to identify the first week of a year See also week0Type(). Note week0Type has no effect beside for intervals classified as QwtDate::Week. Definition at line 115 of file qwt_date_scale_draw.cpp. Qt::TimeSpec QwtDateScaleDraw::timeSpec () const Returns Time specification used for the tick labels See also setTimeSpec(), utcOffset(), toDateTime() Definition at line 74 of file qwt_date_scale_draw.cpp. QDateTime QwtDateScaleDraw::toDateTime (double value) const Translate a double value into a QDateTime object. Returns QDateTime object initialized with timeSpec() and utcOffset(). See also timeSpec(), utcOffset(), QwtDate::toDateTime() Definition at line 269 of file qwt_date_scale_draw.cpp. int QwtDateScaleDraw::utcOffset () const Returns Offset in seconds from Coordinated Universal Time Note The offset has no effect beside for the time specification Qt::OffsetFromUTC. See also QDate::setUtcOffset(), setTimeSpec(), toDateTime() Definition at line 101 of file qwt_date_scale_draw.cpp. QwtDate::Week0Type QwtDateScaleDraw::week0Type () const Returns Setting how to identify the first week of a year. See also setWeek0Type() Definition at line 124 of file qwt_date_scale_draw.cpp. Author Generated automatically by Doxygen for Qwt User's Guide from the source code. Version 6.2.0 Sun Jul 18 2021 QwtDateScaleDraw(3)