fDateTime (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Functions for managing external files

Equivalence and execution speed

Managing errors

Operating mode in the different operating systems

Operating mode in Windows Vista (and later)

See also

Constants for the external files

Functions for managing external files

Handling the external files

Storing files in Android

Summary table: Managing the application directories according to the platform

fDetectRemovableStorage

fReadLineRegularExpression

fRemoveDir

fRename

fReportsAndQueriesDir

Equivalence and execution speed
Managing errors
Operating mode in the different operating systems
Operating mode in Windows Vista (and later)

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

fDateTime (Function)

In french: fDateHeure

Returns or modifies the different dates and times associated with a file or directory (creation, modification or access).

Versions 18 and later

This function is now available in Windows Store apps mode.

New in version 18

This function is now available in Windows Store apps mode.

Versions 21 and later

This function is now available in Universal Windows 10 App mode.

New in version 21

This function is now available in Universal Windows 10 App mode.

Example

See additional examples

// Find out the date and time of file modification
ResDate = fDateTime("C:\MyDirectories\File.txt", "", fModify)

Syntax

<Result> = fDateTime(<Path of file / directory> [, <New date and time> [, <Type of date and time>]])

<Result>: Character string

Date and time associated with the file or directory (in YYYYMMDDHHMMSS format),
Empty string ("") if an error occurred. To find out the error details, use ErrorInfo.

<Path of file / directory>: Character string (with quotes)

Name and full (or relative) path of file (up to 260 characters).
Full (or relative) path of directory (up to 260 characters). If this parameter corresponds to a directory name, this name may (or may not) end with "\". A UNC path can be used.

<New date and time>: Optional character string (with quotes)

Modify a date and time: new date and time associated with the file or directory (in YYYYMMDDHHMMSS format).
Read a date and time: empty string ("").

<Type of date and time>: Optional constant

Specifies the date and the time to use:
fAccess Date and time of last access to the file or directory.
This constant is not available.
fCreation Date and time of file/directory creation.
The creation date of a file or directory cannot be modified.
This constant is not available.
fModify
(Default value) Date and time of last modification made to the file/directory.
Only the files whose date is after 1st of January 1970 can be modified.

Remarks

Equivalence and execution speed

fDateTime is equivalent to fDate and fTime used successively. However, fDateTime is faster.

Managing errors

fDateTime generates an error in the following cases:

the specified file is opened or the file is locked by another application,
the specified file or directory does not exist,
the name of the specified file is invalid,
the year of one of the file dates is before 1980,
the format of <New date and time> is incorrect.
...

Operating mode in the different operating systems

The date and time of a file or directory cannot be modified in the following operating systems: Windows 98, Windows ME.

The creation date and time of a file or directory cannot be modified.

Only the files whose date is after 1st of January 1970 can be modified.

Operating mode in Windows Vista (and later)

If this function does not operate properly in Windows Vista (and later), check whether the file or directory used is not in one of the system directories (Windows directory or "Program Files" directory).

Indeed, in Windows Vista (and later), with the UAC mechanism (User Account Control) enabled, you must have the administrator privileges to handle and/or modify the files or directories in the system directories (Windows directory or "Program Files" directory).

Programming tip: To handle and/or modify the files or directories without administrator privileges, you should:

avoid writing into the Windows directory or into the "Program Files" directory,
use the system directory corresponding to the application (returned by SysDir associated with the srCommonAppData constant).

Component : wd260std.dll