KSystemTimeZoneBackend Class Reference

Backend class for KSystemTimeZone class. More...

#include <ksystemtimezone.h>

Inheritance diagram for KSystemTimeZoneBackend:

List of all members.

Public Member Functions
	KSystemTimeZoneBackend (KSystemTimeZoneSource *source, const QString &name, const QString &countryCode, float latitude, float longitude, const QString &comment)
	~KSystemTimeZoneBackend ()
virtual KTimeZoneBackend *	clone () const
virtual bool	isDst (const KTimeZone *caller, time_t t) const
virtual bool	isDstAtUtc (const KTimeZone *caller, const QDateTime &utcDateTime) const
virtual int	offset (const KTimeZone *caller, time_t t) const
virtual int	offsetAtUtc (const KTimeZone *caller, const QDateTime &utcDateTime) const
virtual int	offsetAtZoneTime (const KTimeZone *caller, const QDateTime &zoneDateTime, int *secondOffset) const
virtual QByteArray	type () const

---

Detailed Description

Backend class for KSystemTimeZone class.

This class implements KSystemTimeZone's constructors and virtual methods. A backend class is required for all classes inherited from KTimeZone to allow KTimeZone virtual methods to work together with reference counting of private data.

Backend class for KSystemTimeZone class

See also:

KTimeZoneBackend, KSystemTimeZone, KTimeZone

Author:

David Jarvie <djarvie@kde.org>.

Definition at line 320 of file ksystemtimezone.h.

---

Constructor & Destructor Documentation

KSystemTimeZoneBackend::KSystemTimeZoneBackend	(	KSystemTimeZoneSource *	source,
		const QString &	name,
		const QString &	countryCode,
		float	latitude,
		float	longitude,
		const QString &	comment
	)

Implements KSystemTimeZone::KSystemTimeZone().

Definition at line 537 of file ksystemtimezone.cpp.

KSystemTimeZoneBackend::~KSystemTimeZoneBackend

(

)

Definition at line 542 of file ksystemtimezone.cpp.

---

Member Function Documentation

KTimeZoneBackend * KSystemTimeZoneBackend::clone

(

)

const [virtual]

Creates a copy of this instance.

Returns:

new copy

Reimplemented from KTimeZoneBackend.

Definition at line 545 of file ksystemtimezone.cpp.

bool KSystemTimeZoneBackend::isDst	(	const KTimeZone *	caller,
		time_t	t
	)		const [virtual]

Implements KSystemTimeZone::isDst().

Returns whether daylight savings time is in operation at a specified UTC time.

Parameters:

caller	calling KSystemTimeZone object
t	the UTC time, measured in seconds since 00:00:00 UTC 1st January 1970 (as returned by time(2))

Returns:

true if daylight savings time is in operation, false otherwise

Reimplemented from KTimeZoneBackend.

Definition at line 664 of file ksystemtimezone.cpp.

bool KSystemTimeZoneBackend::isDstAtUtc	(	const KTimeZone *	caller,
		const QDateTime &	utcDateTime
	)		const [virtual]

Implements KSystemTimeZone::isDstAtUtc().

Returns whether daylight savings time is in operation at the given UTC date/time.

Note that system times are represented using time_t. An error occurs if the date falls outside the range supported by time_t.

Parameters:

caller	calling KSystemTimeZone object
utcDateTime	the UTC date/time. An error occurs if utcDateTime.timeSpec() is not Qt::UTC.

Returns:

true if daylight savings time is in operation, false otherwise

Reimplemented from KTimeZoneBackend.

Definition at line 659 of file ksystemtimezone.cpp.

int KSystemTimeZoneBackend::offset	(	const KTimeZone *	caller,
		time_t	t
	)		const [virtual]

Implements KSystemTimeZone::offset().

Returns the offset of this time zone to UTC at a specified UTC time.

The offset is the number of seconds which you must add to UTC to get local time in this time zone.

Parameters:

caller	calling KSystemTimeZone object
t	the UTC time at which the offset is to be calculated, measured in seconds since 00:00:00 UTC 1st January 1970 (as returned by time(2))

Returns:

offset in seconds, or 0 if error

Reimplemented from KTimeZoneBackend.

Definition at line 629 of file ksystemtimezone.cpp.

int KSystemTimeZoneBackend::offsetAtUtc	(	const KTimeZone *	caller,
		const QDateTime &	utcDateTime
	)		const [virtual]

Implements KSystemTimeZone::offsetAtUtc().

Returns the offset of this time zone to UTC at the given UTC date/time.

The offset is the number of seconds which you must add to UTC to get local time in this time zone.

Note that system times are represented using time_t. An error occurs if the date falls outside the range supported by time_t.

Parameters:

caller	calling KSystemTimeZone object
utcDateTime	the UTC date/time at which the offset is to be calculated. An error occurs if utcDateTime.timeSpec() is not Qt::UTC.

Returns:

offset in seconds, or 0 if error

Reimplemented from KTimeZoneBackend.

Definition at line 624 of file ksystemtimezone.cpp.

int KSystemTimeZoneBackend::offsetAtZoneTime	(	const KTimeZone *	caller,
		const QDateTime &	zoneDateTime,
		int *	secondOffset
	)		const [virtual]

Implements KSystemTimeZone::offsetAtZoneTime().

Returns the offset of this time zone to UTC at the given local date/time. Because of daylight savings time shifts, the date/time may occur twice. Optionally, the offsets at both occurrences of dateTime are calculated.

The offset is the number of seconds which you must add to UTC to get local time in this time zone.

Parameters:

caller	calling KSystemTimeZone object
zoneDateTime	the date/time at which the offset is to be calculated. This is interpreted as a local time in this time zone. An error occurs if zoneDateTime.timeSpec() is not Qt::LocalTime.
secondOffset	if non-null, and the zoneDateTime occurs twice, receives the UTC offset for the second occurrence. Otherwise, it is set the same as the return value.

Returns:

offset in seconds. If zoneDateTime occurs twice, it is the offset at the first occurrence which is returned.

Reimplemented from KTimeZoneBackend.

Definition at line 555 of file ksystemtimezone.cpp.

QByteArray KSystemTimeZoneBackend::type

(

)

const [virtual]

Returns the class name of the data represented by this instance.

Returns:

"KSystemTimeZone"

Reimplemented from KTimeZoneBackend.

Definition at line 550 of file ksystemtimezone.cpp.

---

The documentation for this class was generated from the following files:

• ksystemtimezone.h
• ksystemtimezone.cpp