Click above to get retro games delivered to your door ever month!

  STAMP() 

          Many times date and time stamps are the only way to know when a
          database was last used.  The STAMP functions provides the
          programmer with the ability to change the date and/or time of any
          file.  If no date and time are given in the function call, the
          STAMP function will set the date and time of the file to the
          current date and time as maintained by DOS.


      Format: 

               stamp(filename [,date] [,time])


      Parameters: 

               filename..Character string variable or constant, non case
                         sensitive, which contains the filename to STAMP.
                         STAMP will not accept filenames containing wildcards
                         (* & ?) but paths and alternate drives are
                         acceptable.

               date......Date variable or constant which is the date to set
                         the file to.  If DATE is not specified, and TIME is
                         specified, the file's date stamp will not be
                         affected.

               time......Character string variable or constant containing the
                         time to set the file to.  The time format should be
                         HH:MM:SS but seconds are not necessary (eg. HH:MM is
                         also valid).  If TIME is not specified, and DATE is
                         specified, the file's time stamp will not be
                         affected.

                         If no parameters are specified other than the
                         FILENAME, the date and time will be obtained from
                         DOS and the file's date and time stamps will be
                         updated accordingly.

      Examples: 

               1.   Set all of the DBF files in the directory to a specific
                    date and time.

                    .
                    .
                    .
                    aDate = ctod("10/22/86")
                    aTime = "10:12:15"
                    filename = sdir("*.*","first")
                    do while .not. empty(filename)
                         stamp(filename,aDate,aTime)
                         filename = sdir('next')
                    enddo
                    .
                    .
                    .


      Returns: 

               Nothing.


      Cautions: 

               The file being STAMPed should not currently be opened by any
               other process.  Close all files first.