CVersitDaylight Class Reference

#include <app/vprop.h>

Link against: versit.lib

class CVersitDaylight : public CBase

Inherits from

  • CVersitDaylight

    Detailed Description

    Universal time offset information, including the daylight savings offset.

    This class deals with the daylight saving offset: a one hour offset that occurs in many countries during part of the year. This offset needs to be taken into account when converting Versit times (TVersitDateTimes) between universal and machine-local times.

    This class stores information about the offset, including its length in seconds, when it takes effect and the standard time designations.

    Note that the universal offset (iOffset) is the sum of the daylight saving offset and any time zone offset, as it is the absolute offset from GMT.

    An instance of this class is owned by the CParserPropertyValueDaylight class.

    Member Attribute Documentation

    iDaylightDesignation

    HBufC *iDaylightDesignation

    The daylight saving time designation, e.g. BST, EDT.

    iEndTime

    TVersitDateTime *iEndTime

    The date/time at which the period for daylight saving ends.

    iOffset

    The absolute offset from GMT, which is the sum of the time zone and daylight saving offsets (in seconds).

    iSavings

    TBool iSavings

    The daylight savings flag: this is ETrue if daylight saving is in effect in the locale and EFalse if not.

    iStandardDesignation

    HBufC *iStandardDesignation

    The standard time designation, e.g. GMT, EST.

    iStartTime

    TVersitDateTime *iStartTime

    The date/time at which the period for daylight saving begins.

    iStartTimeSortKey

    TInt64 iStartTimeSortKey

    A sort key than can be used when sorting an array of properties by start date/time.

    Constructor & Destructor Documentation

    ~CVersitDaylight ( )

    IMPORT_C~CVersitDaylight()

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

    Member Function Documentation

    NewL ( TBool, TTimeIntervalSeconds, TVersitDateTime *, TVersitDateTime *, const TDesC &, const TDesC & )

    IMPORT_C CVersitDaylight *NewL(TBoolaSavings,
    TTimeIntervalSecondsaOffset,
    TVersitDateTime *aStartTime,
    TVersitDateTime *aEndTime,
    const TDesC &aStandardDesignation,
    const TDesC &aDaylightDesignation
    )[static]

    Allocates and constructs a new universal time offset object.

    Ownership of aStartTime and aEndTime is taken at end of this function.

    ParameterDescription
    aSavingsThe daylight savings flag, i.e. ETrue if daylight saving is currently observed in the locale; EFalse if not.
    aOffsetThe universal time offset (in seconds).
    aStartTimeThe date/time at which the period for daylight saving begins.
    aEndTimeThe date/time at which the period for daylight saving ends.
    aStandardDesignationThe standard time designation, e.g. GMT, EST.
    aDaylightDesignationThe daylight saving time designation, e.g. BST, EDT.

    Returns: The new universal time offset object.