#include <tzdata.h>

Public Types
enum	WeekDay { Sunday =0, Monday =1, Tuesday =2, Wednesday =3, Thursday =4, Friday =5, Saturday =6 }

Public Member Functions
	TimeStamp ()

	TimeStamp (qint64 ts, bool isLocal=true)

	TimeStamp (qint64 ts, QString zone)

	TimeStamp (qint64 ts, quint16 msec, bool isLocal=true)

	TimeStamp (qint64 ts, quint16 msec, QString zone)

	TimeStamp (const QDate &, bool isLocal=true)

	TimeStamp (const QDate &, QString)

	TimeStamp (const QTime &, bool isLocal=true)

	TimeStamp (const QTime &, QString)

	TimeStamp (const QDateTime &ts)

	TimeStamp (const QDateTime &ts, bool isLocal)

	TimeStamp (const QDateTime &ts, QString zone)

	TimeStamp (const TimeStamp &)

void	addDays (int d)

void	addMSecs (int msec)

void	addSecs (int sec)

quint8	day () const

quint8	hour () const

quint8	minute () const

quint8	month () const

void	moveToLocal ()

void	moveToUTC ()

bool	moveToZone (QString)

quint16	msecs () const

qint32	offsetFromUTC () const

	operator QDate () const

	operator QDateTime () const

	operator QTime () const

bool	operator!= (const TimeStamp &ts) const

bool	operator< (const TimeStamp &ts) const

bool	operator<= (const TimeStamp &ts) const

TimeStamp &	operator= (const TimeStamp &)

bool	operator== (const TimeStamp &ts) const

bool	operator> (const TimeStamp &ts) const

bool	operator>= (const TimeStamp &ts) const

quint8	second () const

void	setLocal ()

void	setUTC ()

bool	setZone (QString)

QDate	toDate () const

QDateTime	toDateTime () const

QString	toISO () const

TimeStamp	toLocal () const

QDateTime	toSystemDateTime () const

QDateTime	toSystemDateTimeUTC () const

QTime	toTime () const

qint64	toUnix () const

TimeStamp	toUTC () const

TimeStamp	toZone (QString zone) const

WeekDay	weekDay () const

qint16	year () const

QString	zone () const

QString	zoneAbbreviation () const

TimeZoneLib::TZFile	zoneFile () const
	returns an instance of this time stamp's current zone file (or one that represents just the UTC-offset if there is none) More...

Static Public Member Functions
static QString	defaultZone ()

static TimeZoneLib::TZFile	defaultZoneFile ()
	returns a copy of the default zone file More...

static void	forgetDefaultZone ()

static TimeStamp	fromDate (int year, quint8 month, quint8 day, bool isLocal=true)

static TimeStamp	fromDate (QDate dt, bool isLocal=true)

static TimeStamp	fromDate (int year, quint8 month, quint8 day, QString zone)

static TimeStamp	fromDate (QDate dt, QString zone)

static TimeStamp	fromDateTime (QDateTime dt)

static TimeStamp	fromDateTime (QDateTime dt, bool isLocal)

static TimeStamp	fromDateTime (QDateTime dt, QString zone)

static TimeStamp	fromDateTime (QDate dt, QTime tm)

static TimeStamp	fromDateTime (QDate dt, QTime tm, bool isLocal)

static TimeStamp	fromDateTime (QDate dt, QTime tm, QString zone)

static TimeStamp	fromDateTime (int year, quint8 month, quint8 day, quint8 hour, quint8 minute, bool isLocal=true)

static TimeStamp	fromDateTime (int year, quint8 month, quint8 day, quint8 hour, quint8 minute, quint8 second, bool isLocal=true)

static TimeStamp	fromTime (quint8 hour, quint8 minute, bool isLocal=true)

static TimeStamp	fromTime (quint8 hour, quint8 minute, quint8 second, bool isLocal=true)

static TimeStamp	fromTime (quint8 hour, quint8 minute, QString zone)

static TimeStamp	fromTime (quint8 hour, quint8 minute, quint8 second, QString zone)

static TimeStamp	fromTime (QTime tm, bool isLocal=true)

static TimeStamp	fromTime (QTime tm, QString zone)

static bool	loadZone (QString zone)

static TimeStamp	now (QString zone)

static TimeStamp	now (bool isLocal=true)

static void	resetRepository ()

static bool	setDefaultZone (QString zone)

static void	setSearchPath (const QStringList &)

static void	storeDefaultZone ()

static QString	systemLocalZone ()

static TimeZoneLib::TZFile	systemLocalZoneFile ()
	returns a copy of the system local zone file More...

Detailed Description

represents the TZ's idea of a time stamp - it uses time zone names in the Olsen notation (eg. "Europe/Berlin")

This class always calculates according to the Gregorian calendar, even for dates preceding its introduction (1582 in most western regions, even after 1900 in some localities).

Valid time zones are strings of the form "Region/City", these are mapped to file names relative to the repository. Zones are checked for invalid characters before being accepted, invalid zones are generally replaced by UTC.

Warning: at the moment this class is not thread safe!

Member Enumeration Documentation

enum TimeStamp::WeekDay

numerical constants for week days

Enumerator
Sunday
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday

Constructor & Destructor Documentation

TimeStamp::TimeStamp ( )

creates a zero timestamp (it matches Epoch and resides on the UTC zone)

References initDefault().

TimeStamp::TimeStamp	(	qint64	ts,
		bool	isLocal = `true`
	)

creates a timestamp from a unix time

Parameters

ts	the unix timestamp to use
isLocal	whether the default time zone should be used, true per default

References defaultzone, and initDefault().

TimeStamp::TimeStamp	(	qint64	ts,
		QString	zone
	)

creates a timestamp from a unix time

Parameters

ts	the unix timestamp to use
zone	the zone it will reside on initially, if the zone is not found it will use UTC instead

References initDefault().

TimeStamp::TimeStamp	(	qint64	ts,
		quint16	msec,
		bool	isLocal = `true`
	)

creates a timestamp from a unix time

Parameters

ts	the unix timestamp to use
msec	the milli-seconds beyond that timestamp
isLocal	whether the default time zone should be used, true per default

References defaultzone, and initDefault().

TimeStamp::TimeStamp	(	qint64	ts,
		quint16	msec,
		QString	zone
	)

creates a timestamp from a unix time

Parameters

ts	the unix timestamp to use
msec	the milli-seconds beyond that timestamp
zone	the zone it will reside on initially, if the zone is not found it will use UTC instead

References initDefault().

TimeStamp::TimeStamp	(	const QDate &	dt,
		bool	isLocal = `true`
	)

creates a timestamp from a QDate, the internal time is set to 0:00:00.000, per default assumes local time

References defaultzone, and initDefault().

TimeStamp::TimeStamp	(	const QDate &	dt,
		QString	zone
	)

creates a timestamp from a QDate assuming it to represent midnight on the given time zone

References initDefault().

TimeStamp::TimeStamp	(	const QTime &	tm,
		bool	isLocal = `true`
	)

creates a timestamp from a QTime, using today as date, per default assumes that the time is local - if the default time zone differs from the system time zone this may lead to misinterpretations

References defaultzone, and initDefault().

TimeStamp::TimeStamp	(	const QTime &	tm,
		QString	z
	)

creates a timestamp from QTime, using today on the given time zone as date, the timestamp is local to the given time zone

References initDefault().

TimeStamp::TimeStamp ( const QDateTime & ts )

creates a timestamp from QDateTime, it converts the QDateTime object to UTC before assigning it, most QDateTime objects created without specifying an explicit time zone are assigned local time by Qt; if the timestamp was of local time the timestamp then moves to the default zone, this may or may not match the zone set by the system, so the resulting timestamp may show time for a different zone

Parameters

ts	timestamp to be converted

References defaultzone, and initDefault().

TimeStamp::TimeStamp	(	const QDateTime &	ts,
		bool	isLocal
	)

creates a timestamp from QDateTime, it ignores the settings of the ts object and uses isLocal to convert it into a UTC based timestamp

Parameters

ts	timestamp to be converted
isLocal	if set to true the timestamp is interpreted to be of the default time zone

References defaultzone, initDefault(), and tm.

TimeStamp::TimeStamp	(	const QDateTime &	ts,
		QString	zone
	)

creates a timestamp from QDateTime, the settings of the ts object are ignored and it is interpreted to be in the given time zone

Parameters

ts	timestamp to be converted
zone	the time zone this QDateTime is interpreted to represent, if it does not exist it is interpreted to be UTC

References initDefault(), and tm.

TimeStamp::TimeStamp ( const TimeStamp & t )

copies a timestamp

Member Function Documentation

void TimeStamp::addDays ( int d )

adds d days to this timestamp

References TimeZoneLib::SecondsPerDay.

void TimeStamp::addMSecs ( int msec )

adds msec milli-seconds to this timestamp

References TimeZoneLib::fdiv(), and TimeZoneLib::pmod().

void TimeStamp::addSecs ( int sec )

adds sec seconds to this timestamp

quint8 TimeStamp::day ( ) const

inline

returns the day of month of this timestamp according to its own zone

QString TimeStamp::defaultZone ( )

static

returns the name of the current default time zone; returns "UTC" as a fallback

References defaultzone, and initDefault().

TimeZoneLib::TZFile TimeStamp::defaultZoneFile ( )

static

returns a copy of the default zone file

References defaultzone, and TimeZoneLib::getRegistryZone().

void TimeStamp::forgetDefaultZone ( )

static

makes the app forget its default configuration (next time setDefaultZone is called with an empty string it will guess again)

static TimeStamp TimeStamp::fromDate	(	int	year,
		quint8	month,
		quint8	day,
		bool	isLocal = `true`
	)

inlinestatic

convenience function: constructs a timestamp from a specific date, sets the time to 0:00:00

static TimeStamp TimeStamp::fromDate	(	QDate	dt,
		bool	isLocal = `true`
	)

inlinestatic

convenience function: constructs a timestamp from a specific date, sets the time to 0:00:00

static TimeStamp TimeStamp::fromDate	(	int	year,
		quint8	month,
		quint8	day,
		QString	zone
	)

inlinestatic

convenience function: constructs a timestamp from a specific date, sets the time to 0:00:00

static TimeStamp TimeStamp::fromDate	(	QDate	dt,
		QString	zone
	)

inlinestatic

convenience function: constructs a timestamp from a specific date, sets the time to 0:00:00

static TimeStamp TimeStamp::fromDateTime ( QDateTime dt )

inlinestatic