home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 177.lha / DRes_v1.3 / docs / timedate.doc < prev    next >
Text File  |  1988-04-28  |  968b  |  37 lines
  1.  
  2.  
  3.                    TIMEDATE.DOC
  4.  
  5.     Useful routines...
  6.  
  7. SetFileDate                            SetFileDate
  8.  
  9.     DOSBOOL =  SetFileDate(file, date)
  10.     char *file;
  11.     DATESTAMP *date;
  12.  
  13.     This routine sets the datestamp for a file by implementing the new
  14.     ACTION_SETDATE Dos packet.    0 is returned on failure, non-zero (-1)
  15.     on success.
  16.  
  17.     NOTE:   The routine will fail if the file has been locked, shared or
  18.     otherwise.
  19.  
  20.  
  21. DateToS                             DateToS
  22.  
  23.     buf = DateToS(date, buf, format)
  24.  
  25.     DATESTAMP *date;
  26.     char *buf;
  27.     char *format;
  28.  
  29.     This routine calculates the ascii time and date from the datestamp and
  30.     jams it into the output buffer (which is returned) according to the
  31.     specified format string.  If the format string is NULL, "D M Y h:m:s"
  32.     is used.  Essentially, the characters D,M,Y,h,m, and s are replaced by
  33.     their ascii date equivalents (day, month, year, hours, minutes, seconds)
  34.     in the output buffer, with all other characters copied verbatim.
  35.  
  36.  
  37.