HELPLIB.HLB  —  System Services, $NUMTIM
    Converts an absolute or delta time from 64-bit system time format
    to binary integer date and time values.

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

    Format

      SYS$NUMTIM  timbuf ,[timadr]

    C Prototype

      int sys$numtim  (unsigned short int timbuf [7], struct

                      _generic_64 *timadr);

1  –  Arguments

 timbuf

    OpenVMS usage:vector_word_unsigned
    type:         word (unsigned)
    access:       write only
    mechanism:    by 32- or 64-bit reference (Alpha and Integrity
                  servers)
    Buffer into which $NUMTIM writes the converted date and time.
    The timbuf argument is the 32- or 64-bit address (on Alpha and
    Integrity server systems) of a 7-word structure.

    Refer to the VSI OpenVMS System Services Reference Manual to view
    the diagram of the fields in this structure.

    If the timadr argument specifies a delta time, $NUMTIM returns
    the value 0 in the year since 0 and month of year fields. It
    returns in the day of month field the number of days specified by
    the delta time.

 timadr

    OpenVMS usage:date_time
    type:         quadword
    access:       read only
    mechanism:    by 32- or 64-bit reference (Alpha and Integrity
                  servers)
    The 64-bit time value to be converted. The timadr argument is the
    32- or 64-bit address (on Alpha and Integrity server systems) of
    a quadword containing this time. A positive-time value represents
    an absolute time, while a negative time value indicates a delta
    time.

    If you do not specify timadr, $NUMTIM returns the current system
    time.

    If timadr specifies the value 0, $NUMTIM returns the base date
    (November 17, 1858).
Close Help