(PYVMS LOGO) Python on OpenVMS

(go to: table of contents, index, list of vms_lib, prev: FIND_IMAGE_SYMBOL, next: FORMAT_SOGW_PROT)


FORMAT_DATE_TIME - Format Date and/or Time

Format:
    status, context, date_string = vms_lib.format_date_time \
                      ([date], [user-context], flags)
Returns:
status
Condition value as returned by LIB$FORMAT_DATE_TIME.
context
Updated context value from the 'user-context' argument. If omitted this will be 'None'.
date_string
Formatted output.
Arguments:
date
Date and time to be formatted for output. 64-bit system time - a Python 'long integer'.
See GENMAN 'Programming', 'special OpenVMS datatypes' for details.
user-context
A context value that has previously been set by vms_lib.init_date_time_context().
flags
Bitmasks like LIB_M_DATE_FIELDS are available from module vms_libdtdef.
Examples:
>>> import vms_lib
>>> import vms_libdtdef


>>> print vms_lib.format_date_time ()
(1, None, ' 8-AUG-1999 17:45:00.42')
>>>


>>> import vms_sys
>>> q_bintim = vms_sys.bintim ('29-FEB-2000 12:34:56.78')
>>> print vms_lib.format_date_time (q_bintim, None)
(1, None, '29-FEB-2000 12:34:56.78')
>>> print vms_lib.format_date_time (q_bintim, None, \
...              vms_libdtdef.LIB_M_DATE_FIELDS)
(1, None, '29-FEB-2000')
>>>


>>> context = 0
>>> month_name = "|Jan|**Feb**|Mrz|Apr|Mai|Jun|" + \
...              "Jul|Aug|Sep|Okt|Nov|Dez|"
>>> context = vms_lib.init_date_time_context (context,
...               vms_libdtdef.LIB_K_MONTH_NAME_ABB, month_name) 
>>>
>>> print vms_lib.format_date_time (q_bintim, context, \
...              vms_libdtdef.LIB_M_DATE_FIELDS)
(1, 2755304, '29-**Feb**-2000')
>>>

(go to: table of contents, index, list of vms_lib, prev: FIND_IMAGE_SYMBOL, next: FORMAT_SOGW_PROT)

08-AUG-1999 ZE.