ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / WLanguage functions / Standard functions / External file functions
  • Modifying the date and time associated with a file
  • Managing the seconds
  • Handling errors
  • Operating mode in the different operating systems
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Returns or modifies the different times associated with a file or directory (date created, modified or accessed).
Syntax
<Result> = fTime(<File or directory path> [, <New time> [, <Type of time>]])
<Result>: Character string
  • Time associated with the file or directory (in HHMMSS format),
  • Empty string ("") if an error occurred. To get more details on the error, use ErrorInfo with the errMessage constant.
<File or directory path>: Character string
  • Name and full (or relative) path of file (up to 260 characters).
  • Full (or relative) path of directory (up to 260 characters).
A UNC path can be used. If this parameter corresponds to a directory name, this name may (or may not) end with "\".
AndroidAndroid Widget 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: In Android, the file system is read-only on the device and on the emulator. An application can only write to its setup directory or one of its subdirectories, as well as to the external memory (SDCard).
iPhone/iPadIOS WidgetMac Catalyst 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/iPad, an application has the rights to write into its setup directory or into one of its subdirectories.
<New time>: Optional character string
  • Modifying a time: new time associated with the specified file or directory (in HHMMSS format),
  • Reading a time: empty string ("").
<Type of time>: Optional constant
Indicates the time to use:
fAccessTime of last access to the file or directory.
AndroidAndroid Widget This constant is not available.
fCreationTime of file/directory creation.
AndroidAndroid Widget This constant is not available.
fModify
(Default value)
Time of last modification made to the file or directory.
Remarks
AndroidAndroid Widget Stored procedures

Modifying the date and time associated with a file

To modify the date and time associated with a file, you have the ability to use fDateTime.
Remark: You can also call fDate and fTime successively. However, fDateTime is faster.

Managing the seconds

All the methods for disk formatting (FAT, NTSF, ...) are not precise to the second. Depending on the method used, fTime may round the time passed as parameter
For example, for a FAT drive, the time for file access has a precision of one day. Therefore, the access time is "000000" and it cannot be modified.

Handling errors

fTime throws an error in the following cases:
  • the specified file is opened or locked by another application,
  • the specified file does not exist,
  • the name of the specified file is invalid,
  • the format of <New time> is incorrect. A WLanguage error occurs if the format of <New time> is incorrect.
  • a Unicode string was used for <Path of file or directory> in an operating system such as Windows 98 or Windows Me.

Operating mode in the different operating systems

  • The time associated with a file or a directory cannot be modified in the following systems: Windows 98, Windows ME.
Component: wd300std.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 09/30/2024

Send a report | Local help