FileCDaTi

FileCDaTi

Determines which date the target file contains with a FileCopy().

Syntax

      FileCDaTi([<lNewMode>]) --> <lOldMode>

Argument

<lNewMode> : Designates the new status for FileCDaTi(). When .T. is designated, the target file contains the source file date; when it is .F., the system date. The default is the source file date (.T.).

Returns

If no parameter is designated, FileCDaTi() returns the current setting for FileCDaTi(); otherwise, it returns the previous setting.

Description

FILE COPY DATE TIME

FileCDaTi() Determines whether a source file’s date and time stamp or the system’s date and time stamp, should be used to create or copy a file. Use original or system time for a file copy process.

When you partition to several disks in backup mode, this concerns all target files. Default is .T., where the target file contains the date and time of the source file. If you call FileCDaTi() with the parameter designated .F., then the target file contains the system date and time.

Notes

. Use this function before FileCopy().

. If the target file contains a unique setting such as a pseudo serialization, use the SETFDATI() function.

Examples

      .  Query the FileCDaTi() setting:
         ? FileCDaTi()            // The current setting
      .  The target file is to contain the system date and time:
         ? FileCDaTi(.F.)         // Returns the previous setting

Seealso

FileCopy(),  FileCCont(), FileCClose()

CT_SETFDATI

 SETFDATI()
 Sets the date and time of a file

 Syntax

     SETFDATI(<cFile>, [<dFileDate>], [<cFileTime>]) --> lAmended

 Arguments

     <cFile>  Designates for which file the date and/or time is changed.
     Drive and path designations are possible, wildcards are not.

     <dFileDate>  Designates the date for the file.  The default is the
     system date.

     <cFileTime>  Designates the time for the file.  The default is the
     system time.

 Returns

     SETFDATI() returns .T. when the change is successfully executed.

 Description

     SETFDATI() permits you to set the clock date and time of a file.  Since
     the date and time of a file usually change at the same time, these have
     been brought together in one function.  It is possible to only change
     the time or the date, when one parameter is given and the other is not.
     The different parameter types tell the function what is to change.

 Note

     .  The time is given in a 24-hour format, that is between
        "00:00:00" and "23:59:59".

 Examples

     .  Set the date and time:

        SETFDATI("C:\TEXT\TEST.TXT", CTOD("01/01/91"), "01:10:00")

     .  Set current date and time:

        SETFDATI("TEST.TXT")                  // DATE() + TIME()

     .  Only change the date:

        SETFDATI("TEST.TXT", DATE() -10)      // Ten days prior to today

     .  Only change the time, resetting to start time:

        SETFDATI("TEST.TXT", SECTOTIME(Start))

See Also: FILESEEK() FILEDATE() FILETIME() SECTOTIME()

 

Tools — Disk Utilities

Introduction Disk Utilities
DELETEFILE() Deletes an error-tolerant file
DIRCHANGE()  Changes the current directory
DIRMAKE()    Creates a directory
DIRNAME()    Determines the name of the current directory
DIRREMOVE()  Removes a directory
DISKCHANGE() Changes the current disk drive
DISKCHECK()  Creates a checksum for a disk
DISKFORMAT() Formats disks, controlled through a UDF
DISKFREE()   Determines the space available on a floppy or hard disk
DISKNAME()   Determines the drive designator for the current drive
DISKREADY()  Tests to see if a disk drive is ready
DISKREADYW() Queries whether you can write to a drive
DISKSPEED()  Determines a comparison value for the drive speed
DISKSTAT()   Determines the status of a drive.
DISKTOTAL()  Determines the total capacity of a floppy or hard disk
DISKTYPE()   Determines the type of data carrier
DRIVETYPE()  Determines the drive type
FILEAPPEND() Appends data to a file
FILEATTR()   Determines a file's attributes
FILECCLOSE() Closes a file after backup mode
FILECCONT()  Copies sections of a file in backup mode
FILECDATI()  Determines which date the target file contains with FILECOPY()
FILECHECK()  Calculates/computes/determines a checksum for a file
FILECOPEN()  Tests to see if the file is still open in the backup mode
FILECOPY()   Copies files normally or in backup mode
FILEDATE()   Determines the file date
FILEDELETE() Deletes file(s) by name and attribute
FILEMOVE()   Moves files to another directory
FILESEEK()   Searches for files by name and attribute
FILESIZE()   Determines the size of a file
FILESTR()    Reads a portion of a file into a string
FILETIME()   Determines a file's time
FILEVALID()  Tests whether a string has a valid file name
FLOPPYTYPE() Determines the exact type of floppy drive
GETSHARE()   Determines the file open (share) mode
NUMDISKF()   Determines the number of installed disk drives
NUMDISKH()   Determines the number of hard disks
NUMDISKL()   Determines the number of available logical drives
RENAMEFILE() Fault tolerant renaming of a file.
RESTFSEEK()  Restores the FILESEEK environment
SAVEFSEEK()  Saves the current FILESEEK environment
SETFATTR()   Sets a file's attributes
SETFCREATE() Default attribute for creating with CA-Clipper Tools functions
SETFDATI()   Sets the date and time of a file
SETSHARE()   Sets default opening mode for CA-Clipper Tools file functions
STRFILE()    Writes a string to a file
TEMPFILE()   Creates a file for temporary use
TRUENAME()   Standardizes the path designation
VOLSERIAL()  Determines the DOS disk serial number
VOLUME()     Establishes a volume label for a floppy or hard disk