CTzId Class Reference

#include <mw/tzid.h>

Link against: tzclient.lib

class CTzId : public CBase

Inherits from

  • CTzId

    Detailed Description

    Encapsulates a time zone identifier.

    The identifier may be either a name or a number.

    Since
    9.1

    Constructor & Destructor Documentation

    ~CTzId ( )

    IMPORT_C~CTzId()

    Destructor.

    Member Function Documentation

    CloneL ( )

    IMPORT_C CTzId *CloneL()const

    This should not be used. For internal use only.

    Replicates a CTzId.

    leave
    KErrNoMemory or some other system error code.

    Returns: A pointer to CTzId; clients own the object.

    ExternalizeL ( RWriteStream & )

    IMPORT_C voidExternalizeL(RWriteStream &aStream)const

    This should not be used. For internal use only.

    Time zone ID data externaliser.

    ParameterDescription
    aStreamA stream that will contain the serialised time zone ID.

    InternalizeL ( RReadStream & )

    IMPORT_C voidInternalizeL(RReadStream &aStream)

    This should not be used. For internal use only.

    Serialised CTzId data internaliser.

    ParameterDescription
    aStreama stream containing the serialised time zone Id

    IsUserTzId ( )

    IMPORT_C TBoolIsUserTzId()const

    Determines if this time zone identifier has a numeric identifier value that belongs to the range of values used to identify user-defined time zones.

    Returns: Returns ETrue if this time zone identifier has a numeric identifier value that belongs to the range of values used to identify user-defined time zones and EFalse otherwise.

    IsUserTzId ( TUint )

    IMPORT_C TBoolIsUserTzId(TUintaTzId)[static]

    Determines if the given numeric time zone identifier value belongs to the range of values used to identify user-defined time zones.

    ParameterDescription
    aTzIdNumeric time zone identifier value.

    Returns: Returns ETrue if the given numeric time zone identifier value belongs to the range of values used to identify user-defined time zones and EFalse otherwise.

    NewL ( TUint )

    IMPORT_C CTzId *NewL(TUintaNumericId)[static]

    Time zone ID factory method.

    panic
    TzServer 8 aNumericId must not be zero.
    ParameterDescription
    aNumericIdA numeric reference ID, generated by the time zone compiler.

    Returns: A pointer to the time zone ID. Clients take ownership.

    NewL ( const TDesC8 & )

    IMPORT_C CTzId *NewL(const TDesC8 &aNameIdentity)[static]

    Time zone ID factory method.

    ParameterDescription
    aNameIdentityA name recognised by the time zone database.

    Returns: A pointer to the time zone ID. Clients take ownership.

    NewL ( RReadStream & )

    IMPORT_C CTzId *NewL(RReadStream &aStream)[static]

    This should not be used. For internal use only.

    Time zone ID factory method.

    leave
    KErrNoMemory or some other system error code
    ParameterDescription
    aStreama stream containing the serialised time zone Id

    Returns: Pointer to CTzId; clients own the object.

    SetId ( TUint )

    IMPORT_C voidSetId(TUintaNumericId)

    This should not be used. For internal use only.

    Sets the numeric time zone ID.

    ParameterDescription
    aNumericIdThe new numeric ID, generated by the time zone compiler.

    SetIdL ( const TDesC8 & )

    IMPORT_C voidSetIdL(const TDesC8 &aNameIdentity)

    This should not be used. For internal use only.

    Sets the the time zone's name.

    ParameterDescription
    aNameIdentitystring TZID as used in the Olson's TZ Database

    SetIdL ( TUint, const TDesC8 & )

    voidSetIdL(TUintaNumRefId,
    const TDesC8 &aZoneIdentity
    )

    TimeZoneNameID ( )

    IMPORT_C const TDesC8 &TimeZoneNameID()const

    Retrieves the time zone's name.

    This can be used after calling RTz::GetTimeZoneIdL().

    Returns: The time zone's name, if one has been set. A NULL descriptor if not.

    TimeZoneNumericID ( )

    IMPORT_C TUintTimeZoneNumericID()const

    Retrieves the time zone's numeric ID.

    This can be used after calling RTz::GetTimeZoneIdL().

    Returns: The time zone's numeric ID, generated by the time zone compiler.

    operator!= ( const CTzId & )

    TBool operator!=(const CTzId &aTZId)const [inline]

    Inequality operator.

    ParameterDescription
    aTZIdThe time zone ID to compare with this one.

    Returns: ETrue if the two IDs are different, EFalse if they are the same.

    operator== ( const CTzId & )

    IMPORT_C TBooloperator==(const CTzId &aTZId)const

    Equality operator.

    ParameterDescription
    aTZIdThe ID of another time zone.

    Returns: ETrue if the specified time zone ID is the same as this one, otherwise EFalse.