- bookworm 6.1.4-2
- testing 6.1.4-2
- unstable 6.1.4-2
- experimental 6.2.0-1
QwtDate(3) | Qwt User's Guide | QwtDate(3) |
NAME¶
QwtDate - A collection of methods around date/time values.
SYNOPSIS¶
#include <qwt_date.h>
Public Types¶
enum Week0Type { FirstThursday, FirstDay }
enum IntervalType { Millisecond, Second, Minute,
Hour, Day, Week, Month, Year }
enum { JulianDayForEpoch = 2440588 }
Static Public Member Functions¶
static QDate minDate ()
static QDate maxDate ()
static QDateTime toDateTime (double value, Qt::TimeSpec=Qt::UTC)
static double toDouble (const QDateTime &)
static QDateTime ceil (const QDateTime &, IntervalType)
static QDateTime floor (const QDateTime &, IntervalType)
static QDate dateOfWeek0 (int year, Week0Type)
Date of the first day of the first week for a year. static int
weekNumber (const QDate &, Week0Type)
static int utcOffset (const QDateTime &)
static QString toString (const QDateTime &, const QString
&format, Week0Type)
Detailed Description¶
A collection of methods around date/time values.
Qt offers convenient classes for dealing with date/time values, but Qwt uses coordinate systems that are based on doubles. QwtDate offers methods to translate from QDateTime to double and v.v.
A double is interpreted as the number of milliseconds since 1970-01-01T00:00:00 Universal Coordinated Time - also known as 'The Epoch'.
While the range of the Julian day in Qt4 is limited to [0, MAX_INT], Qt5 stores it as qint64 offering a huge range of valid dates. As the significance of a double is below this ( assuming a fraction of 52 bits ) the translation is not bijective with rounding errors for dates very far from Epoch. For a resolution of 1 ms those start to happen for dates above the year 144683.
An axis for a date/time interval is expected to be aligned and divided in time/date units like seconds, minutes, ... QwtDate offers several algorithms that are needed to calculate these axes.
See also
Definition at line 42 of file qwt_date.h.
Member Enumeration Documentation¶
anonymous enum¶
Enumerator
- JulianDayForEpoch
- The Julian day of 'The Epoch'.
Definition at line 102 of file qwt_date.h.
enum QwtDate::IntervalType¶
Classification of an time interval
Time intervals needs to be classified to decide how to align and divide it.
Enumerator
- Millisecond
- The interval is related to milliseconds.
- Second
- The interval is related to seconds.
- Minute
- The interval is related to minutes.
- Hour
- The interval is related to hours.
- Day
- The interval is related to days.
- Week
- The interval is related to weeks.
- Month
- The interval is related to months.
- Year
- The interval is related to years.
Definition at line 75 of file qwt_date.h.
enum QwtDate::Week0Type¶
How to identify the first week of year differs between countries.
Enumerator
- FirstThursday
- According to ISO 8601 the first week of a year is defined as 'the week with the year's first Thursday in it'.
FirstThursday corresponds to the numbering that is implemented in QDate::weekNumber().
In the U.S. this definition is more common than FirstThursday.
Definition at line 49 of file qwt_date.h.
Member Function Documentation¶
QDateTime QwtDate::ceil (const QDateTime & dateTime, IntervalType intervalType) [static]¶
Ceil a datetime according the interval type
Parameters
intervalType Interval type, how to ceil. F.e. when intervalType = QwtDate::Months, the result will be ceiled to the next beginning of a month
Returns
See also
Definition at line 323 of file qwt_date.cpp.
QDate QwtDate::dateOfWeek0 (int year, Week0Type type) [static]¶
Date of the first day of the first week for a year. The first day of a week depends on the current locale ( QLocale::firstDayOfWeek() ).
Parameters
type Option how to identify the first week
Returns
See also
Definition at line 542 of file qwt_date.cpp.
QDateTime QwtDate::floor (const QDateTime & dateTime, IntervalType intervalType) [static]¶
Floor a datetime according the interval type
Parameters
intervalType Interval type, how to ceil. F.e. when intervalType = QwtDate::Months, the result will be ceiled to the next beginning of a month
Returns
See also
Definition at line 425 of file qwt_date.cpp.
QDate QwtDate::maxDate () [static]¶
Maximum for the supported date range
The range of valid dates depends on how QDate stores the Julian day internally.
- For Qt4 it is 'Tue Jun 3 5874898'
- For Qt5 it is 'Tue Dec 31 2147483647'
Returns
See also
Note
Definition at line 521 of file qwt_date.cpp.
QDate QwtDate::minDate () [static]¶
Minimum for the supported date range
The range of valid dates depends on how QDate stores the Julian day internally.
- For Qt4 it is 'Tue Jan 2 -4713'
- For Qt5 it is 'Thu Jan 1 -2147483648'
Returns
See also
Definition at line 499 of file qwt_date.cpp.
QDateTime QwtDate::toDateTime (double value, Qt::TimeSpec timeSpec = Qt::UTC) [static]¶
Translate from double to QDateTime
Parameters
timeSpec Time specification
Returns
See also
Note
Definition at line 261 of file qwt_date.cpp.
double QwtDate::toDouble (const QDateTime & dateTime) [static]¶
Translate from QDateTime to double
Parameters
Returns
See also
Warning
Definition at line 298 of file qwt_date.cpp.
QString QwtDate::toString (const QDateTime & dateTime, const QString & format, Week0Type week0Type) [static]¶
Translate a datetime into a string
Beside the format expressions documented in QDateTime::toString() the following expressions are supported:
- w
week number: ( 1 - 53 ) - ww
week number with a leading zero ( 01 - 53 )
As week 1 usually starts in the previous year a special rule is applied for formats, where the year is expected to match the week number - even if the date belongs to the previous year.
Parameters
format Format string
week0Type Specification of week 0
Returns
See also
Definition at line 686 of file qwt_date.cpp.
int QwtDate::utcOffset (const QDateTime & dateTime) [static]¶
Offset in seconds from Coordinated Universal Time
The offset depends on the time specification of dateTime:
- Qt::UTC 0, dateTime has no offset
- Qt::OffsetFromUTC returns dateTime.offsetFromUtc()
- Qt::LocalTime: number of seconds from the UTC
For Qt::LocalTime the offset depends on the timezone and daylight savings.
Parameters
Returns
Definition at line 635 of file qwt_date.cpp.
int QwtDate::weekNumber (const QDate & date, Week0Type type) [static]¶
Find the week number of a date
- QwtDate::FirstThursday
Corresponding to ISO 8601 ( see QDate::weekNumber() ). - QwtDate::FirstDay
Number of weeks that have begun since dateOfWeek0().
Parameters
type Option how to identify the first week
Returns
Definition at line 585 of file qwt_date.cpp.
Author¶
Generated automatically by Doxygen for Qwt User's Guide from the source code.
Sun Jul 18 2021 | Version 6.2.0 |