FTPDate (Function)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Date associated with a file
Timeout
Internet browser
Rights of users
Relative and absolute path

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

FTPDate (Function)

In french: FTPDate

Returns the different dates (creation, modification or access) associated with a file found on an FTP server (File Transfer Protocol).

Example

See additional examples

// Find out the date of modification made to
// "/Documents/File.txt" found on the FTP server
ResDate = FTPDate(ConnectionNum, "/Documents/File.txt")

Syntax

Finding out the different dates associated with the last file viewed Hide the details

<Result> = FTPDate([<Type of date>])

<Result>: Character string

Date (in YYYYMMDD format) associated with the last file viewed via one of the following FTP functions: FTPAttribute, FTPTime, FTPSize, FTPListFile.
Empty string ("") if an error occurred. To find out the error details, use ErrorInfo associated with the errMessage constant.
Unlike the 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:
ftpAccess Date of last access to the file.
ftpCreation Date of file creation.
ftpModification
(Default value) Date of last file modification.

Finding out the different dates associated with the specified file Hide the details

<Result> = FTPDate(<Connection identifier> , <File name> [, <Type of date>])

<Result>: Character string

Date associated with the specified file (in YYYYMMDD format),
Empty string ("") if an error occurred. To find out the error details, use ErrorInfo associated with the errMessage constant.

<Connection identifier>: Integer

Connection identifier, returned by FTPConnect.

<File name>: Character string (with quotes)

Name and full (or relative) path of file to use. The different path sections are separated by "slashes" ("/").

<Type of date>: Optional constant

Indicates the date to handle:
ftpAccess Date of last access to the file.
ftpCreation Date of file creation.
ftpModification
(Default value) Date of last file modification.

Remarks

Date associated with a file

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 this same day, the date may be less than the actual date by one year.

Timeout

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

Internet browser

FTPDate requires Internet Explorer version 3 or later.

If a problem occurs, we recommend that you run a test with the browser by directly passing a link such as "ftp://server/...". If a problem occurs with Internet Explorer (with a UNIX server for example), use FTPCommand directly.

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.

Component : wd250com.dll