/sys$common/syshlp/HELPLIB.HLB  —  Lexicals  F$CVTIME  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.
Close Help