Date/Time Handling Functions char *mail_date (char *string,MESSAGECACHE *elt); string destination string elt message cache element containing date This function accepts a message cache element that contains date information, and writes an IMAP-4 date string, that is, one in form: dd-mmm-yyyy hh:mm:ss +zzzz based upon the data in the elt. The destination string must be large enough to hold this string. char *mail_cdate (char *string,MESSAGECACHE *elt); string destination string elt message cache element containing date This function accepts a message cache element that contains date information, and writes a ctime() format date string, that is, one in form: www mmm dd hh:mm:ss yyyy\n based upon the data in the elt. The destination string must be large enough to hold this string. long mail_parse_date (MESSAGECACHE *elt,char *string); elt message cache element to store parsed date string source date string This function parses the date/time stored in the given string, in format: [www,] date [[hh:mm[:ss][-zzz| +zzzz] where the date can be any of: mm/dd/yy, mm/dd/yyyy, dd-mmm-yy, dd-mmm-yyyy, dd mmm yy, dd mmm yyyy and stores the result of the parse in the elt. If the parse is successful, T is returned, else NIL. unsigned long mail_longdate (MESSAGECACHE *elt); elt message cache element containing date. This function accepts a message cache element that contains date information, and returns the number of days since the base time of the imap-4 toolkit. At present, this is the same as the Unix time() value for that date/time, and hence can be used for functions such as utime().