ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Communication / FTP functions
  • File date
  • Timeout
  • Rights of users
  • Relative and absolute path
  • Required permissions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Returns the different dates of a file (date the file was created, modified or accessed) located on an FTP server (File Transfer Protocol).
JavaPHP Returns the date a file located on an FTP server was last modified (File Transfer Protocol).
// Get the modification date of
// "/Documents/File.txt" on the FTP server
ResDate = FTPDate(ConnectionNum, "/Documents/File.txt")
Syntax

Getting the different dates of the last file accessed Hide the details

<Result> = FTPDate([<Type of date>])
<Result>: Character string
  • Date (in YYYYMMDD format) of the last file accessed via one of the following FTP functions: FTPAttribute, FTPTime, FTPSize, FTPListFile.
  • Empty string ("") if an error occurred. To get more details on the error, use ErrorInfo with the errMessage constant.
LinuxAndroidAndroid Widget JavaPHP Modification date of the last file accessed.
Unlike syntax 2, no request is sent to the server. Therefore, this syntax is recommended whenever possible.
<Type of date>: Optional constant
Indicates the date to handle:
ftpAccessDate the file was last accessed.
ftpCreationDate the file was created.
ftpModification
(Default value)
Date the file was last modified.
LinuxAndroidAndroid Widget JavaPHP This parameter is not available. Only the date the file was last modified is returned.

Getting the different dates of the specified file Hide the details

<Result> = FTPDate(<Connection identifier> , <File name> [, <Type of date>])
<Result>: Character string
  • Date of the specified file (in YYYYMMDD format),
  • Empty string ("") if an error occurred. To get more details on the error, use ErrorInfo with the errMessage constant.
LinuxAndroidAndroid Widget JavaPHP Modification date of the last file accessed.
<Connection identifier>: Integer
Connection identifier, returned by FTPConnect.
PHP This parameter is a Variant parameter.
<File name>: Character string
Name and full (or relative) path of the file be accessed. The different path sections are separated by "slashes" ("/").
<Type of date>: Optional constant
Indicates the date to handle:
ftpAccessDate the file was last accessed.
ftpCreationDate the file was created.
ftpModification
(Default value)
Date the file was last modified.
LinuxAndroidAndroid Widget JavaPHP This parameter is not available. Only the date the file was last modified is returned.
Remarks

File date

Due to a bug in a Microsoft component, the year returned by FTPDate may be invalid for some versions of Internet Explorer 5.0. If the file was created or modified on the same day, the date may be one year earlier than the actual date.

Timeout

By default, all the FTP functions fail if the FTP server does not respond within 20 seconds. This timeout can be modified with FTPConnect when connecting to the FTP server.

Rights of users

Only a user who has read rights on the FTP server can get information about the files or the directories found on an FTP server. In most cases, the read rights are granted to the "anonymous" users.

Relative and absolute path

The notions of relative path and absolute path are very important in an FTP application.
  • A path starting with a slash is considered as being an absolute path: it is the path in relation to the root of the FTP server (parameter specific to the server).
    ex: /ad/user/JULIA
  • A path not starting with a slash is considered as being a relative path, which means a path given in relation to the current directory. This current directory can be returned or modified by FTPCurrentDir.
When connecting to an FTP site, the initial directory (the "home directory" of the user) is not necessarily found at the root of the FTP server. Therefore, we recommend that you use relative paths.
AndroidAndroid Widget

Required permissions

The call to this function modifies the permissions required by the application.
Required permission : INTERNET
This permission allows the applications to open the network sockets.
Component: wd290com.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help