Class CParserTimePropertyValue

CParserTimePropertyValue

Support

Supported from 5.0

Description

Abstract base class for all of the date/time property value classes (CParserPropertyValueAlarm, CParserPropertyValueDate, CParserPropertyValueDateTime, CParserPropertyValueMultiDateTime, CParserPropertyValueDaylight, CParserPropertyValueRecurrence). Provides date/time conversion functions between machine-local and universal time.

Derivation

CBase Base class for all classes to be instantiated on the heap CParserPropertyValue Abstract base class for all property values CParserTimePropertyValue Abstract base class for all of the date/time property value classes (CParserPropertyValueAlarm, CParserPropertyValueDate, CParserPropertyValueDateTime, CParserPropertyValueMultiDateTime, CParserPropertyValueDaylight, CParserPropertyValueRecurrence)

Defined in CParserTimePropertyValue:
ConvertAllDateTimesToUTCL(), ConvertAllUTCDateTimesToMachineLocalL(), SupportsInterface()

Inherited from CBase:
operator new()

Inherited from CParserPropertyValue:
EncodeL(), ExternalizeL(), IsAsciiCharacterSetSufficient(), Uid()

virtual void ConvertAllDateTimesToUTCL(const TTimeIntervalSeconds& aIncrement,const CVersitDaylight* aDaylight)=0;

Description

Converts a machine-local date/time property value into universal time. This is normally a two stage process; the time zone offset should be removed, and the daylight saving offset (if daylight saving is in effect) should be removed.

Parameters

const TTimeIntervalSeconds& aIncrement A time interval in seconds which represents the time zone's offset from universal time. const CVersitDaylight* aDaylight Pointer to the daylight saving specification. If the date/time value is within the period for daylight saving, the daylight saving offset should be removed.

virtual void ConvertAllUTCDateTimesToMachineLocalL(const TTimeIntervalSeconds& aIncrement)=0;

Description

Converts the property value stored as universal time into machine-local time. This process involves adjusting the date/time value by the daylight saving offset (if daylight saving is in effect) and by the time zone offset.

Parameters

const TTimeIntervalSeconds& aIncrement A time interval which represents the number of seconds which should be added to the date/time value.

virtual TBool SupportsInterface(const TUid& aInterfaceUid) const;

Description

Tests whether a property value supports the CParserTimePropertyValue interface. This overrides the base class implementation, for non-time related property value classes (which always returns EFalse) to return ETrue if KVersitTimePropertyUid is specified.

Parameters

const TUid& aInterfaceUid Used to identify whether or not a property value is time related (derived from CParserTimePropertyValue). Specify KVersitTimePropertyUid if it is.

Return value

TBool ETrue if KVersitTimePropertyUid is specified, otherwise EFalse.