HELPLIB.HLB  —  System Services, $ASCTIM
    Converts an absolute or delta time from 64-bit system time format
    to an ASCII string.

    On Alpha and Integrity server systems, this service accepts 64-
    bit addresses.

    Format

      SYS$ASCTIM  [timlen] ,timbuf ,[timadr] ,[cvtflg]

    C Prototype

      int sys$asctim  (unsigned short int *timlen, void *timbuf,

                      struct _generic_64 *timadr, char cvtflg);

1  –  Arguments

 timlen

    OpenVMS usage:word_unsigned
    type:         word (unsigned)
    access:       write only
    mechanism:    by 32- or 64-bit reference
    Length (in bytes) of the ASCII string returned by $ASCTIM.
    The timlen argument is the the 32- or 64-bit address of a word
    containing this length.

 timbuf

    OpenVMS usage:time_name
    type:         character-coded text string
    access:       write only
    mechanism:    by 32- or 64-bit descriptor-fixed-length string
                  descriptor
    Buffer into which $ASCTIM writes the ASCII string. The timbuf
    argument is the 32- or 64-bit address of a character string
    descriptor pointing to the buffer.

    The buffer length specified in the timbuf argument, together with
    the cvtflg argument, controls what information is returned.

 timadr

    OpenVMS usage:date_time
    type:         quadword
    access:       read only
    mechanism:    by 32- or 64-bit reference
    Time value that $ASCTIM is to convert. The timadr argument is
    the 32- or 64-bit address of this 64-bit time value. A positive
    time value represents an absolute time. A negative time value
    represents a delta time. If you specify a delta time, it must be
    less than 10,000 days.

    If timadr is not specified or is specified as 0 (the default),
    $ASCTIM returns the current date and time.

 cvtflg

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    Conversion indicator specifying which date and time fields
    $ASCTIM should return. The cvtflg argument is a longword
    value, which is interpreted as Boolean. The value 1 specifies
    that $ASCTIM should return only the hour, minute, second, and
    hundredths-of-second fields. The default value 0 specifies that
    $ASCTIM should return the full date and time.
Close Help