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 recent GETNEXTFILE  script command.

 

[ label ]

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

Options:

none

 

 

 

Form 1 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 recent GETNEXTFILE 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, IFDATE