Symbian
Symbian OS Library

SYMBIAN OS V9.3

[Index] [Spacer] [Previous] [Next]



Location: caltime.h
Link against: calinterimapi.lib

Class TCalTime

class TCalTime;

Description

Represents a date/time, as used in the Calendar API.

This stores a single TTime, which may be set in UTC or local or floating local time, and can be retrieved in either UTC or system local time.

There are references to null time throughout the Interim API - this means Time::NullTTime().

Members

Defined in TCalTime:
EFixedTimeZone, EFixedUtc, EFloating, MaxTime(), MinTime(), SetTimeLocalFloatingL(), SetTimeLocalL(), SetTimeUtcL(), TCalTime(), TTimeMode, TimeLocalL(), TimeMode(), TimeUtcL()

See also


Construction and destruction


TCalTime()

Capability: Illegal

IMPORT_C TCalTime();

Description

Constructor for the TCalTime class. The time is initialised to Time::NullTTime().

[Top]


Member functions


SetTimeLocalFloatingL()

Capability: Illegal

IMPORT_C void SetTimeLocalFloatingL(const TTime &aLocalTime);

Description

Sets the time to a local floating time value. Time values set using this API are said to be "floating" and are not bound to any time zone in particular. Floating time is used to represent the same time regardless of which time zone it is currently being observed from. This is described in RFC2445 as FORM #1: DATE WITH LOCAL TIME.

Parameters

const TTime &aLocalTime

The time to be set in floating local time.

Leave codes

KErrArgument

If the given time is not null but smaller than TCalTime::MinTime() or bigger than TCalTime::MaxTime()


SetTimeUtcL()

Capability: Illegal

IMPORT_C void SetTimeUtcL(const TTime &aUtcTime);

Description

Sets the time to a UTC value. Time values set using this API are said to be "fixed". Fixed times in UTC format can be converted to the equivalent local time in any time zone using RTz, or converted to the local time of the current system time zone by calling TimeLocalL(). This is described in RFC2445 as FORM #2: DATE WITH UTC TIME.

Parameters

const TTime &aUtcTime

The time to be set in UTC.

Leave codes

KErrArgument

If the given time is not null but smaller than TCalTime::MinTime() or bigger than TCalTime::MaxTime()


SetTimeLocalL()

Capability: Illegal

IMPORT_C void SetTimeLocalL(const TTime &aLocalTime);

Description

Sets the time to a local time value bound to the current system time zone. Time values set using this API are said to be "fixed". The local time can be converted to an equivalent local time in any other time zone by calling TimeUtcL() and then converting the UTC time to the equivalent local time zone using RTz. This is described in RFC2445 as FORM #3: DATE WITH LOCAL TIME AND TIME ZONE REFERENCE.

Parameters

const TTime &aLocalTime

The time to be set in system-local time.

Leave codes

KErrArgument

If the given time is not null but smaller than TCalTime::MinTime() or bigger than TCalTime::MaxTime()


TimeMode()

IMPORT_C TTimeMode TimeMode() const;

Description

Returns the time mode that the time has been set to, whether it be floating local time, fixed UTC time, or fixed local time.

Return value

TTimeMode

Time mode of the calendar time


TimeUtcL()

Capability: Illegal

IMPORT_C TTime TimeUtcL() const;

Description

Returns the fixed or floating time as UTC.

Return value

TTime

The time in UTC.


TimeLocalL()

Capability: Illegal

IMPORT_C TTime TimeLocalL() const;

Description

Returns the fixed or floating time as local time. If the time is fixed, the time is converted to the local time of the current system time zone before being returned.

Return value

TTime

The time in system-local time.


MaxTime()

Capability: Illegal

static IMPORT_C TTime MaxTime();

Description

Get the maximum time allowed in the Interim API. Note that this time is the same for UTC and system local time - it can't be converted.

Return value

TTime

The maximum time.


MinTime()

Capability: Illegal

static IMPORT_C TTime MinTime();

Description

Get the minimum time allowed in the Interim API. Note that this time is the same for UTC and system local time - it can't be converted.

Return value

TTime

The minimum time.

[Top]


Member enumerations


Enum TTimeMode

TTimeMode

Description

The time mode for a calendar time

EFloating

Floating time.

EFixedUtc

Fixed time in UTC format.

EFixedTimeZone

Fixed time in local time with time zone reference format.