Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

[Index] [Glossary] [Previous] [Next]



Agenda Model Utilities Overview


Purpose

This API is a collection of classes which are used by the other agenda model-related APIs. It allows date and time conversion between agenda date and time formats and standard representations of dates and times.

[Top]


Architectural relationships

The Agenda Model Utilities API is used by the other agenda model-related APIs for its date and time conversion functions and for the agenda model panic enum values. It uses the Date And Time Handling API which is the interface to the standard representations of date and time.

[Top]


Description

Dates and times in the agenda model-related APIs are stored using TUint16 integers rather than instances of the standard TTime class. This scheme saves space when storing agenda entries but it imposes a more limited date range — from 1st January 1980 to 31st December 2100. Dates are represented as a number of days from the start of this range. Using dates outside the range raises a EAgmErrDateOutsideOfValidRange panic (AGNMODEL panic 10). Times are stored as a number of minutes from midnight, so the valid time range is 0 to 1439 inclusive.

[Top]


See also

Date And Time Handling Overview

Agenda File Overview

Agenda Entry and Instance Overview

Agenda Server Client Side Overview

To-do List Overview