Date/time handling functions

• mail_date

  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, based upon the data in the elt, writes an IMAP-4 date string, that is, one in the following form:

  dd-mmm-yyyy hh:mm:ss +zzzz
  

  The destination string must be large enough to hold this string.

• mail_cdate

  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, based upon the data in the elt, writes a ctime format date string, that is, one in the following form:

  www mmm dd hh:mm:ss yyyy\n
  

  The destination string must be large enough to hold this string.

• mail_parse_date

  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, using the following format:

  [www,] date [[hh:mm[:ss][-zzz| +zzzz]
  

  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.

• mail_longdate

  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 IMAP4 toolkit. At present, this is the same as the UNIX system time value for that date/time, and hence can be used for functions such as utime.