ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Communication / FTP functions
  • Timeout
  • Rights of users
  • Relative and absolute path
  • Relative and absolute path
  • Required permissions
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Returns the different creation, modification or access times associated with a file located on an FTP server (File Transfer Protocol).
JavaPHP Returns the modification time of a file located on an FTP server.
New in SaaS
A new syntax for manipulating variables of type ftpConnection is available from WINDEV Suite SaaS 2025 - Update 2.
// Find out the time of modification made to
// "/Documents/File.txt" on the FTP server
ResTime = FTPTime(7, "/Documents/File.txt")
New in SaaS
// Syntax not available in PHP
// Connect the current computer to the FTP server
MyFTPConnection is ftpConnection
MyFTPConnection.Server = "192.54.12.8"
FTPConnect(MyFTPConnection)

// Find out the time of modification made to
// "/Documents/File.txt" on the FTP server
ResTime = FTPTime(MyFTPConnection, "/Documents/File.txt")
Syntax
New in SaaS
PHP Syntax not available in PHP

Getting the different times of a file (connection via an ftpConnection variable) Hide the details

<Result> = FTPTime(<FTP connection> [, <File name>] [, <Type of time>])
<Result>: Character string
  • Requested time (HHMMSS format).
    AndroidAndroid Widget Java Only the file modification time is available.
  • Empty string ("") if an error occurred. To get more details on the error, use ErrorInfo with the errMessage constant.
<FTP connection>: ftpConnection variable
Name of the ftpConnection variable that describes the characteristics of the connection to the FTP server.
Note: This variable type is only available from WINDEV Suite SaaS 2025 - Update 2.
<File name>: Optional character string
Name and full (or relative) path of the file be accessed. The different path sections are separated by "slashes" ("/").
If this parameter is not specified, the date returned will be that of the last file accessed using one of the following FTP functions: FTPDate, FTPTime, FTPSize, FTPListFile. In this case, no request is sent to the server. This syntax is recommended.
<Type of time>: Optional constant
Requested time:
ftpAccessTime the file was last accessed.
ftpCreationTime the file was created.
ftpModification
(Default value)
Time the file was last modified.

AndroidAndroid Widget Java This parameter is not available. Only the modification time of the specified file is available.

Getting the different times of a file (connection via the identifier of the connection to the FTP server) Hide the details

<Result> = FTPTime(<Connection ID> , <Name of file#-1> [, <Type of time>]])
<Result>: Character string
  • Requested time (HHMMSS format).
    LinuxAndroidAndroid Widget JavaPHP Only the time the file was last modified is returned.
    • Empty string ("") if an error occurred. To get more details on the error, use ErrorInfo with the errMessage constant.
<Connection ID>: Integer
Connection identifier, returned by FTPConnect.
PHP This parameter is a Variant parameter.
<Name of file#-1>: Character string
Name and full or relative path of the file be accessed. The different path sections are separated by "slashes" ("/").
<Type of time>: Optional constant
Indicates the time to use:
Requested time:
ftpAccessTime the file was last accessed.
ftpCreationTime the file was created.
ftpModification
(Default value)
Time the file was last modified.

AndroidAndroid Widget JavaPHP This parameter is not available. Only the modification time of the specified file is available.
Note: If the <Connection ID> and <File name> parameters are not specified, the time returned will be that of the last file accessed using one of the following FTP functions: FTPDate, FTPTime, FTPSize, FTPListFile. In this case, no request is sent to the server. This syntax is recommended.
Remarks

Timeout

By default, all the FTP functions fail if the FTP server does not respond within 20 seconds. This time can be modified:

Rights of users

Only a user who has read rights on the FTP server can get information about the files or the directories located 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 beginning with a slash is considered an absolute path. This path is relative to the root of the FTP server (server-specific parameter).
    Example: /ad/user/JULIA
  • If the path does not begin with a slash, it is considered a relative path, i.e. the path relative to the current directory. This current directory can be obtained or changed using FTPCurrentDir.
When connecting to an FTP site, the initial directory (the "base directory" of the user) is not necessarily found at the root of the FTP server. Therefore, we recommend that you use relative paths.

Relative and absolute path

The notions of relative path and absolute path are very important in an FTP application.
  • A path beginning with a slash is considered an absolute path. This path is relative to the root of the FTP server (server-specific parameter).
    ex: /pub/user/JULIA
  • If the path does not begin with a slash, it is considered a relative path, i.e. the path relative to the current directory. This current directory can be obtained or changed using FTPCurrentDir.
When connecting to an FTP site, the initial directory (the "base 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

This function changes the permissions required by the application.
Required permission: INTERNET
This permission allows the applications to open the network sockets.
Business / UI classification: Business Logic
Component: wd300com.dll
Minimum version required
  • Version 9
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 04/30/2025

Send a report | Local help