Arguments

input_time

   Specifies a string containing absolute, a delta, or a combination
   time, or TODAY, TOMORROW, or YESTERDAY. Specify the input time
   string as a character string expression.

   If the input_time argument is omitted or is specified as a null
   string (""), the current system date and time, in absolute
   format, is used. If parts of the date field are omitted, the
   missing values default to the current date. If parts of the time
   field are omitted, the missing values default to zero.

   For more information on specifying time values, see the OpenVMS
   User's Manual or the online help topic Date.

   If the input_time argument is a delta time, you must specify the
   output_time_format argument as DELTA.


output_time_format

   Specifies the time format for the information you want returned.
   Specify the output_time_format argument as one of the following
   character string expressions:

   ABSOLUTE    The requested information should be returned
               in absolute time format, which is dd-mmm-yyyy
               hh:mm:ss.cc. Single-digit days are returned with
               no leading space or zero.

   COMPARISON  The requested information should be returned in the
   (default)   form yyyy-mm-dd hh:mm:ss.cc (used for comparing two
               times).

   DELTA       The requested information should be returned in delta
               format, which is dddd-hh:mm:ss.cc. If you specify
               DELTA as the output_time_format argument, then you
               must also provide a delta time specification for the
               input_time argument.


output_field

   Specifies a character string expression containing one of the
   following (do not abbreviate): DATE, MONTH, DATETIME (default),
   SECOND, DAY, TIME, HOUR, WEEKDAY, HUNDREDTH, YEAR, MINUTE,
   DAYOFYEAR, HOUROFYEAR, MINUTEOFYEAR, SECONDOFYEAR.

   The information is returned in the time format specified by the
   output_time_format argument.

   If the input_time argument is a delta time and the output_time_
   format argument is DELTA, you cannot specify MONTH, WEEKDAY,
   YEAR, DAYOFYEAR, HOUROFYEAR, MINUTEOFYEAR, or SECONDOFYEAR.

   When the weekday is returned, the first letter is in uppercase,
   and the following letters are in lowercase.