VMS Help Lexicals, F$CVTIME, Arguments *Conan The Librarian (sorry for the slow response - running on an old VAX) |
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, refer to the OpenVMS User's Manual or the online help topic DCL_Tips (subtopic Date_Time). 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. 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, or YEAR. When the weekday is returned, the first letter is in uppercase, and the following letters are in lowercase.
|