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.
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.
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.