IFTIME        Conditional branch upon time comparison

Top  Previous  Next

Form 1

Syntax:

IFTIMExx

[ time1 ] [ time2 ] goto  [ label ]

Forms:

IFTIME=

[ time1 ] [ time2 ] goto  [ label ]

 

IFTIME<

[ time1 ] [ time2 ] goto  [ label ]

 

IFTIME>

[ time1 ] [ time2 ] goto  [ label ]

 

IFTIME<=

[ time1 ] [ time2 ] goto  [ label ]

 

IFTIME>=

[ time1 ] [ time2 ] goto  [ label ]

 

IFTIME! =

[ time1 ] [ time2 ] goto  [ label ]

Arguments:

[ time1 ]

Variable or string defining a time in the format of hh.mm.ss or hh.mm.

 

[ time2 ]

Variable or string defining a time in the format of hh.mm.ss or hh.mm.

 

[ label ]

A valid label within the current script file which is branched to if the time condition is satisfied.

Options:

none

 

 

Form 2

Syntax:

IFTIMExx

[ time ]  goto  [ label ]

Forms:

IFTIME=

[ time ]  goto  [ label ]

 

IFTIME<

[ time ]  goto  [ label ]

 

IFTIME>

[ time ]  goto  [ label ]

 

IFTIME<=

[ time ]  goto  [ label ]

 

IFTIME>=

[ time ]  goto  [ label ]

 

IFTIME! =

[ time ]  goto  [ label ]

Arguments:

[ time ]

Variable or string defining a time in the format of hh.mm.ss or hh.mm to compare against the time stamp of the file obtained with the most recently executed GETNEXTFILE, GETFILE, GETSITEFILE, or FTPGETFILE script command.

 

[ label ]

A valid label within the current script file which is branched to if the time condition is satisfied.

Options:

none

 

 

 

 

Form1 of this command is used to compare two specified time strings in format of hh.mm.ss

or hh.mm.

 

Form 2 of this command is used in conjunction with the most recently executed GETNEXTFILE, GETFILE, GETSITEFILE, or FTPGETFILE command to compare the time of the file with a specified time string.

 

The time must be expressed in military time (hours 00 through 23), and leading zeroes are required. When times are compared, seconds are always ignored. The following are examples of valid time strings.

 

01.30.001:30AM
17.305:30PM
12.1512:15PM

 

Example of Form 1

 

The following conditional branch is taken if the current time is later than 11AM.

 

IFTIME> %time "11.00.00" goto later time

 

Example of Form 2

 

The following conditional branch is taken if a local file just obtained with the GETNEXTFILE command has a time stamp is older than 5:30PM.

 

GETNEXTFILE "*.txt"

IFTIME< "17.30" goto old file

 

Syntactically, no space is permitted to the left of the ‘!’, '=', '<' or '>' symbols, and a space is required to the right of these symbols.

 

Related Command(s): GETNEXTFILE, GETFILE, GETSITEFILE, FTPGETFILE, IFDATE, IFSIZE

See also: Comparing Local and FTP Site File Dates and Times