The DateTime Service Class

The service class DateTime obtains the current date and time from the operating system and converts them into a form that can be used for comparisons and arithmetic. In this context date values are stored as Julian days since a specified start date, Dec 31,1967 by default, and time values are stored as seconds since midnight. Note that since time is only expressed in seconds no special operating system calls are needed to obtain it.

The method DateTime_GetDateAndTime

Prototype

Code Block
language cpp theme Eclipse linenumbers true
void DateTime_GetDateAndTime(int* DateValue,int* TimeValue);

The DateTime_GetDateAndTime method obtains the current data and time from the operating system and returns them in standard integer value form. The standard date value is simply the number of days that have passed since a specified start date (see JulianZero). The standard integer value form for time is simply the number of seconds since midnight. Its parameters are as follows:

The method DateTime_JulianToDate

Prototype

Code Block
language cpp theme Eclipse linenumbers true
void DateTime_JulianToDate(int Julian,int* Day,int* Month,int* Year);

The DateTime_JulianToDate method converts a relative Julian value into its corresponding date value -- day, month, year. The relative Julian value is simply the number of days that have passed since a specified started date (see JulianZero). Its parameters are as follows:

The method DateTime_ToJulian

Prototype

Code Block
language cpp theme Eclipse linenumbers true
int DateTime_ToJulian(int day,int month,int year);

The DateTime_ToJulian method converts a date value into its relative Julian value. The relative Julian value is simply the number of days that have passed since a specified started date (see JulianZero). Its parameters are as follows:

The method returns the number of days that have passed since the specified start date.