EPOC   SDK Home Glossary Indexes Previous Next Up

CParserPropertyValueDaylight class


Contents


CParserPropertyValueDaylight class — Daylight saving property value

Section Contents


Overview

Compatibility

Applications that use this class will not work correctly on a version of EPOC earlier than ER5.

Derivation

CBase

Abstract: CBase behaviour.

CParserPropertyValue

Abstract: Base class for all property values.

CParserTimePropertyValue

Abstract: Base class for all date and time property values.

Defined in

vprop.h

Link against

versit.lib

Description

This property value contains the specification for the daylight saving rule for a vCalendar entity.

The property value is specified as a pointer to a CVersitDaylight object. CVersitDaylight consists of a sequence of components that define the specification for daylight saving.

The value consists of: —

To find out the property value type, use Uid() defined in the base class CParserPropertyValue. A daylight saving property UID has the value KVersitPropertyDaylightUid.


Construction and destruction


CParserPropertyValueDaylight() — C++ constructor with a daylight saving specification

CParserPropertyValueDaylight(CVersitDaylight* aValue);

Description

Constructs a new CParserPropertyValueDaylight with a CVersitDaylight pointer.

Arguments

CVersitDaylight* aValue

Pointer to the daylight saving specification. The property value takes ownership of the pointer.


~CParserPropertyValueDaylight() — Destructor

~CParserPropertyValueDaylight();

Description

The destructor frees all resources owned by the property, prior to its destruction.


Date/time conversion


ConvertAllDateTimesToUTCL() — Convert start and end date/time to universal time

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

Description

This function converts the start and end times for the daylight saving period into universal time. This will only occur if the CParserPropertyValueDaylight object's daylight saving value specifies that daylight saving is observed, and the start and end times for the daylight saving period are not currently stored in universal time.

The function adds the number of seconds specified in aIncrement, then modifies the resulting date/time value by the daylight saving offset specified in aDaylight, if applicable.

Arguments

const TTimeIntervalSeconds& aIncrement

A time interval in seconds which represents the negative of the time zone of the originating machine.

For instance, if the time zone is +04:30, aIncrement should be set to –04:30.

const CVersitDaylight* aDaylight

The specification for daylight saving. If a date/time value is within the period for daylight saving, the date/time is modified by the daylight saving offset.


ConvertAllUTCDateTimesToMachineLocalL() — Convert start and end date/time to local time

void ConvertAllUTCDateTimesToMachineLocalL(const TTimeIntervalSeconds& aIncrement);

Description

This function converts the start and end times for the daylight saving period from universal time into local time for the target machine.

This will only occur if the CParserPropertyValueDaylight object's daylight saving value specifies that daylight saving is observed, and the start and end times for the daylight saving period are stored in universal time.

Arguments

const TTimeIntervalSeconds& aIncrement

A time interval in seconds to add to the start and end date/times for daylight saving.

This should normally be the universal time offset for the machine's locale.


Property value


Value() — Get the daylight saving property value

CVersitDaylight* Value() const;

Description

Retrieves the daylight saving property value.

Return value

CVersitDaylight*

Pointer to the daylight saving specification.

EPOC       SDK Home Glossary Indexes Previous Next Up