CVTzActualisedRules Class Reference

#include <mw/vtzrules.h>

Link against: tzclient.lib

class CVTzActualisedRules : public CBase

Inherits from

CVTzActualisedRules

Public Member Functions
	~CVTzActualisedRules()
IMPORT_C void	AddRuleL(const TVTzActualisedRule &)
IMPORT_C TInt	Count()
IMPORT_C TInt	EndYear()
IMPORT_C TInt	GetOffsetFromRuleL(const TTime &, TTzTimeReference)
IMPORT_C TBool	IsDaylightSavingOn(TTime &)
IMPORT_C CVTzActualisedRules *	NewL(TInt, TInt)
IMPORT_C TInt	StartYear()
IMPORT_C TVTzActualisedRule &	operator[](TInt)

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()

Detailed Description

Encapsulates a collection of the local time changes occurring during a range of years.

Constructor & Destructor Documentation

~CVTzActualisedRules ( )

IMPORT_C

~CVTzActualisedRules

(

)

Destructor.

Member Function Documentation

AddRuleL ( const TVTzActualisedRule & )

IMPORT_C void

AddRuleL

(

const TVTzActualisedRule &

aRule

)

Add an actualised rule to the collection.

Parameter	Description
aRule	An actualised rule to be added into the collection.

Count ( )

IMPORT_C TInt

Count

(

)

const

Returns number of rules currently held in array of rules.

Returns: Number of rules.

EndYear ( )

IMPORT_C TInt

EndYear

(

)

const

Returns max year of the year range the CVTzActualisedRules object describes the rules for.

Returns: End year (e.g. 2005).

GetOffsetFromRuleL ( const TTime &, TTzTimeReference )

IMPORT_C TInt	GetOffsetFromRuleL	(	const TTime &	aTime,
			TTzTimeReference	aTimeRef
		)	const

Receives a time. Finds out which of these rules applies at the received time and returns the offset in effect at the specified time.

Leaves with KErrNotFound, if it doesn't find the rule (i.e. aTime is earlier than the very first time in CVTzActualisedRules).

Parameter	Description
aTime	- time of interest
aTimeRef	- time reference for the aUserTime (UTC or wall-time) note: ETzStdTimeReference for aTimeRef is not supported, will panic with RTz::EPanicUnsupportedTimeReference.

Returns: TInt - offset from UTC (in minutes).

IsDaylightSavingOn ( TTime & )

IMPORT_C TBool

IsDaylightSavingOn

(

TTime &

aTime

)

const

Tells if Daylight Savings Applies for the current time zone at the current time

panic: RTz 5 if aTime is not covered by the current set of time zone rules.

panic: RTz 7 if one of the time zone rules uses standard time reference.

Parameter	Description
aTime	The time of interest given in UTC.

Returns: EFalse if Daylight Savings does not apply (winter time) and ETrue if Daylight Savings does apply

NewL ( TInt, TInt )

IMPORT_C CVTzActualisedRules *	NewL	(	TInt	aStartYear,
			TInt	aEndYear
		)	[static]

Factory method for CVTzActualisedRules objects. Creates a new instance of CVTzActualizedRules - an array of actualised rules (TVTzActualisedRule).

The array of rules can be populated later by invoking CTzRules::GetActualisedRulesL() method.

Rules in the array are sorted ascending by rule's start time (TVTzActualisedRule.iTimeOfChange); The very first rule in the array, if present, defines "default standard rule" for the time zone indicating the STD time offset from UTC, in effect from the start of the first year (aStartYear).

panic: RTz 10 if aStartYear is larger than aEndYear.

Parameter	Description
aEndYear	- specify range of years for to which actualised rules apply.

Returns: A pointer to the newly created rules.

StartYear ( )

IMPORT_C TInt

StartYear

(

)

const

Returns min year of the year range the CVTzActualisedRules object describes the rules for. It is guaranteed that the array of rules does not contain any rules for years before that min year.

Returns: Start year (e.g. 1998).

operator[] ( TInt )

IMPORT_C TVTzActualisedRule &

operator[]

(

TInt

aIndex

)

const

Returns specified TVTzActualisedRule.

panic: RTz 4 if aIndex is out of bounds.

Parameter	Description
aIndex	Index of a rule

Returns: A reference to TVTzActualised rule at index aIndex.