Collapse all Symbian^3 Product Developer Library

CTzConverter Class Reference

class CTzConverter : public CBase

Converts between time expressed in UTC and local time.

RTz

Since: 9.1

Inherits from

CTzConverter
- CBase

Public Member Functions
	~CTzConverter()
IMPORT_C TInt	ConvertToLocalTime(TTime &)
IMPORT_C TInt	ConvertToLocalTime(TTime &, const CTzId &)
IMPORT_C TInt	ConvertToUniversalTime(TTime &)
IMPORT_C TInt	ConvertToUniversalTime(TTime &, const CTzId &)
IMPORT_C TUint16	CurrentTzId()
IMPORT_C CTzConverter *	NewL(RTz &)
void	NotifyTimeZoneChangeL(RTz::TTzChanges)
const RTz &	Server()

Private Member Functions
	CTzConverter(RTz &)
void	ConstructL()

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()

Private Attributes
TAny *	iReserved
TAny *	iReserved2
RTz &	iTzServer

Constructor & Destructor Documentation

CTzConverter(RTz &)

CTzConverter

(

RTz &

aTzServer

)

[private]

Parameters

RTz & aTzServer

~CTzConverter()

IMPORT_C

~CTzConverter

(

)

Destructor.

Member Functions Documentation

ConstructL()

void

ConstructL

(

)

[private]

ConvertToLocalTime(TTime &)

IMPORT_C TInt

ConvertToLocalTime

(

TTime &

aTime

)

Converts a time from UTC to local (wall-clock) time for the current system time zone.

Parameters

TTime & aTime

On entry, contains the UTC time to be converted and the converted value on exit.

ConvertToLocalTime(TTime &, const CTzId &)

IMPORT_C TInt	ConvertToLocalTime	(	TTime &	aTime,
			const CTzId &	aZone
		)

Converts a time from UTC to the local (wall-clock) time for the specified time zone.

Parameters

TTime & aTime	On entry, contains the UTC time to be converted, and the converted value on exit.
const CTzId & aZone	Time zone ID.

ConvertToUniversalTime(TTime &)

IMPORT_C TInt

ConvertToUniversalTime

(

TTime &

aTime

)

Converts a local (wall-clock) time for the current system time zone into UTC.

Parameters

TTime & aTime

On entry, contains the local time to be converted, and the converted value on exit.

ConvertToUniversalTime(TTime &, const CTzId &)

IMPORT_C TInt	ConvertToUniversalTime	(	TTime &	aTime,
			const CTzId &	aZone
		)

Converts a local (wall-clock) time for the specified time zone into UTC.

Parameters

TTime & aTime	On entry, contains the local time to be converted, and the converted value on exit.
const CTzId & aZone	The time zone ID.

CurrentTzId()

IMPORT_C TUint16

CurrentTzId

(

)

Get the numerical ID of the current time zone.

NewL(RTz &)

IMPORT_C CTzConverter *

NewL

(

RTz &

aTzServer

)

[static]

CTzConverter factory method.

Provides client side caching for conversions in the local time zone. Caching is done through RTz but enabled through this interface. When caching has been enabled by this class and the RTz functions for local time zone conversion are used, they too will use the cache instead of the server. Multiple CTzConverter's can use the same RTz session. Each converter will be notified by the server if the time zone changes, and the cache will be updated appropriately.

To disable caching in RTz, the session must be closed. Caching will be re-enabled if a CTzConverter associated with the RTz is later used again for local time zone conversions.

This will leave with KErrNotReady if the RTz passed in is not connected.

Parameters

RTz & aTzServer

Connection to the time zone server.

NotifyTimeZoneChangeL(RTz::TTzChanges)

void

NotifyTimeZoneChangeL

(

RTz::TTzChanges

aChange

)

Parameters

RTz::TTzChanges aChange

Server()

const RTz &

Server

(

)

const

Member Data Documentation

TAny * iReserved

TAny *

iReserved

[private]

TAny * iReserved2

TAny *

iReserved2

[private]

RTz & iTzServer

RTz &

iTzServer

[private]