m_parse_time

This function parses a null-terminated input string according to rule, and fills in the hour, minute, second, and hundredth fields of the DTM structure, leaving the date fields unaffected. Unspecified fields that do not cause parsing errors are set to 0.

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

0 = rule appropriate to currently selected system time format.
1 - TM_H_M_S_P = 12 hour clock, with optional am/pm specifier.
2 - TM_H_M_S+24 = 24 hour clock.
3 - TM_HM_S_24 = 24 hour clock with hours and minutes together.
4 - TM_H_M_S_C_24 = 24 hour clock to hundredth resolution.
5 - TM_H_M_P = 12 hour clock, without seconds.
6 - TM_H_M_24 = 24 hour clock, without seconds.
7 - TM_HM_24 = 24 hour clock with hours minutes together, without seconds.


Syntax:      int m_parse_time(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 invalid value