Returns the time difference between a given start and end time.
The end time must be the same as or later than the start time.
In newer versions of OpenVMS the lexical function F$DELTA_TIME
does the same.
TimeDiff can be used on any OpenVMS version and will return the
time difference not only in OpenVMS format, but optionaly in
seconds, milliseconds or minutes.
Timediff will always create the following four symbols:
TIMEDIFF$START Start time given to timediff
TIMEDIFF$END End time given to timediff
TIMEDIFF$FORMAT Format used for output value
TIMEDIFF$VALUE Output value
1 /START
/START=<start time>
Absolute time expression of the start time in the following
format:
dd-mmm-yyyy hh:mm:ss.cc
2 /END
/END=<end time>
Absolute time expression of the end time in the following
format:
dd-mmm-yyyy hh:mm:ss.cc
3 /FORMAT
/FORMAT=<Output format> /FORMAT=DELTATIME (default) TimeDiff will return the time difference in the followinf formats: /FORMAT=DELTATIME /FORMAT=SECONDS /FORMAT=MILLISECONDS
4 /OUTPUT
/OUTPUT=<symbol to receive the time difference> TimeDiff needs a symbol to return the time difference to DCL.
5 – Examples
$ TIMEDIFF /START="11-JAN-2007 11:00"/END="11-JAN-2007 11:15" -
/OUTPUT=test
$ SHOW SYMBOL test
TEST = " 0 00:15:00.00"
$ TIMEDIFF /START="11-JAN-2007 11:00"/END="11-JAN-2007 11:15" -
/OUTPUT=test/FORMAT=SECONDS
$ SHOW SYMBOL test
TEST = "900"
$ TIMDIFF /START=17-APR-2012 12:00/END=20-APR-2012 13:30 -
/FORMAT=MINUTES
$ SHOW SYMBOL timediff*
TIMEDIFF$END = "20-APR-2012 13:30"
TIMEDIFF$FORMAT = "MILLISECONDS"
TIMEDIFF$START = "17-APR-2012 12:00"
TIMEDIFF$VALUE = "26460000"