fDateTime (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Standard functions / External file functions

Equivalence and execution speed
Handling errors
Operating mode in the different operating systems

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 (date created, modified or accessed).

Example

See additional examples

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 get more details on the error, use ErrorInfo.

<Path of file / directory>: Character string

Name and full or relative path of the 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.
This parameter can correspond to a full path or a path relative to the current directory (returned by fCurrentDir). This parameter is case-sensitive.
Reminder: Under Android, an application can only write to its installation directory or one of its sub-directories, as well as to external memory (SDCard).
This parameter can correspond to a full path or a path relative to the current directory (returned by fCurrentDir). This parameter is case-sensitive.
Reminder: On iPhone or iPad, an application has the rights to write to its installation directory or one of its subdirectories

<New date and time>: Optional character string

Modification of a date and time: new date and time for the file/directory (in YYYYMMDDHHmmSS format).
Read 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 files with a date later than January 1, 1970 can be modified.

Remarks

Equivalence and execution speed

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

Handling errors

fDateTime throws 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 under the following systems: Windows 98, Windows ME.

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

Only files with a date later than January 1, 1970 can be modified.

Component: wd300std.dll