1 TimeDiff

  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


2 /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


2 /FORMAT

  /FORMAT=<Output format>
  /FORMAT=DELTATIME (default)

  TimeDiff will return the time difference in the followinf formats:

  /FORMAT=DELTATIME          
  /FORMAT=SECONDS            
  /FORMAT=MILLISECONDS

2 /OUTPUT

  /OUTPUT=<symbol to receive the time difference>

  TimeDiff needs a symbol to return the time difference to DCL.

2 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"