Variables representing file names on the server and on the local computer, dates and times

FTPGetter provides a set of variables that represent full file names on the SFTP server and local computer, current date, file modification dates on the SFTP server and local computer, and more. During task execution, these variables contain information related to the file currently being uploaded or downloaded. These values can be used as parameters for executing bat-files, PowerShell scripts, shell scripts on the SFTP server, sending email notifications, and more. Below is the complete list.

%local_file% - substitutes with a full path including the file name to a file on a local or network disk, e.g. “C:\my-docs\report.txt”

%local_file_path% - substitutes with just a path without the file name to a file on a local or network disk, e.g. “C:\my-docs\”

%local_file_name% - substitutes with just a file name without the path to a file on a local or network disk, e.g. “report.txt”

%local_file_name_only% - substitutes with just a file name without the path to a file and extension on a local or network disk, e.g. "report"

%local_file_name_ext% - substitutes with just a file name extension, e.g. "txt"

%remote_file% - substitutes with a full path including the file name to a file available remotely on a network server, e.g. “/pub/user/file.txt”

%remote_file_path% - substitutes with just a path without the file name to a file available remotely on a network server, e.g. “/pub/user/”

%remote_file_name% - substitutes with just a file name without the path to a file available remotely on a network server, e.g. “file.txt”

%remote_file_name_only% - substitutes with just a file name without the path to a file and extension available remotely on a network server, e.g. "file"

%remote_file_name_ext% - substitutes with just a file name extension, e.g. "txt"

%c_dd% - substitutes with the current day in two-digit format with leading zero, “01” to “31”.

%c_mm% - substitutes with the current month with leading zero, “01” to “12”.

%c_yyyy%, %c_yy% - current year in 4-digit or 2-digit format, e.g. “2026” or “26”.

%c_hh% - current time (hours) in 24-hour format with leading zero, “00” to “23”.

%c_min% - current time (minutes) with leading zero, “00” to “59”.

%c_sec% - current time (seconds) with leading zero, "00" to "59".

%y_dd% - substitutes with yesterday’s day in two-digit format with leading zero, “01” to “31”.

%y_mm% - substitutes with yesterday’s month with leading zero, “01” to “12”.

%y_yyyy%, %y_yy% - yesterday’s year in 4-digit or 2-digit format, e.g. “2025” or “25”.

%t_dd% - substitutes with tomorrow’s day in two-digit format with leading zero, “01” to “31”.

%t_mm% - substitutes with tomorrow’s month with leading zero, “01” to “12”.

%t_yyyy%, %t_yy% - tomorrow’s year in 4-digit or 2-digit format, e.g. “2011” or “11”.

Examples

Assuming that today is May 13th, 2026, the following file path:

/pub/user/reports/%c_yyyy%-%c_mm%-%c_dd%/file.txt

Will be substituted into:

/pub/user/reports/2026-05-13/file.txt

, with 2026 representing the year, 05 meaning May, and 13 being the day of the month.

The substitution variables (%c_*****%) can be used to specify paths to source and destination files as well as passed as parameters to external applications.

%s_dd% - source file modification date (day): substitutes with the day number in two-digit format with leading zero, “01” to “31”.

%s_mm% - source file modification date (month): substitutes with a month number with leading zero, “01” to “12”.

%s_yyyy%, %s_yy% - source file modification date (year): substitutes with a year in 4-digit or 2-digit format, e.g. “2026” or “26”.

%s_hh% - source file modification time (hours): substitutes with an hour in 24-hour format with leading zero, “00” to “23”.

%s_min% - source file modification time (minutes): substitutes with a minute with leading zero, “00” to “59”.

%s_sec% - source file modification time (seconds): substitutes with a second with leading zero, "00" to "59".

Examples

The source file specified as:

/pub/user/reports/%s_yyyy%-%s_mm%-%s_dd%/file.txt

Will be accessed with variable substitution by the following real path:

/pub/user/reports/2026-05-13/file.txt

, with 2026 representing the year, 05 meaning May, and 13 being the day of the month when the file was last modified.

The variables that represent source file modification date (%s_*****%) can only be used to specify paths to destination files as parameters specified to the program that is launched after transferring the files.

%remote_host% - substitutes with an FTP site name, e.g. "ftp.example.com:21"

%task_number% - substitutes with the current task number.

%action% - substitutes with the performed action, e.g. "Download" or "Upload"

%result% - substitutes with the performed action result, e.g. "Success" or "Failed"

%list% - substitutes with the transferred files list. Available only in the email body when the "Send email AFTER all files are transferred" option is used.

%list_file_name% - substitutes with the transferred file names list (without paths). Available only in the email body when the "Send email AFTER all files are transferred" option is used.

%files_total% - substitutes with the total number of processed files.

%files_success% - substitutes with the number of successfully processed files.

%files_failed% - substitutes with the number of failed processed files.