m_parse_date

This function parses a null-terminated input string according to rule, and fills in the day, date, week, and year fields of the DTM structure (the time-of-day fields are unaffected). m_parse_date sets unspecified fields that do not cause parsing errors to 0.

The available rules are as follows (found in SETTINGS.H):

Years with the rules above must be in the range of 1900 to 2099. Two-digit input of years is assumed to be in the range of 1980 to 2079. For parsing of arbitrary years, or DR_ANY_YEAR (0x8) onto the rule code.

0 - rule appropriate to currently selected system date format.
1 - DR_DMY_LIM - date, month, year and year must be in limited range.
2 - DR_MDY_LIM - month, date, year and year must be in limited range.
3 - DR_YMD_LIM - year, month, date and year must be in limited range.
4 - DR_MD - just month and date
5 - DR_DM - just date and month
6 - DR_MY_LIM - month and year and year must be in limited range.


Syntax:      int m_parse_date(int rule, char *input, DTM *dtm) 
Parameters:  int rule Rule - by which to parse date information
             char *input - Pointer to data to be parsed 
             DTM *dtm - Pointer to DTM structure to receive parsed data 
Returns:     0 - if parsing is successful 
             Non-zero value - if input is improperly formatted or an invalid value