VMS Help RTL Routines, LIB$, LIB$CVT_FROM_INTERNAL_TIME  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    The Convert Internal Time to External Time routine converts an
    internal OpenVMS system time (either absolute or delta) into an
    external time.

    Format

      LIB$CVT_FROM_INTERNAL_TIME  operation ,resultant-time

                                  [,input-time]

1 - Returns

    OpenVMS usage:cond_value
    type:         longword (unsigned)
    access:       write only
    mechanism:    by value

2 - Arguments

 operation

    OpenVMS usage:function_code
    type:         longword (unsigned)
    access:       read only
    mechanism:    by reference

    The conversion to be performed. The operation argument is the
    address of an unsigned longword containing the operation. The
    following table shows valid values for operation:

    Operation               Type         Return Range

    LIB$K_MONTH_OF_YEAR     Absolute     1 to 12
    LIB$K_DAY_OF_YEAR       Absolute     1 to 366
    LIB$K_HOUR_OF_YEAR      Absolute     1 to 8784
    LIB$K_MINUTE_OF_YEAR    Absolute     1 to 527,040
    LIB$K_SECOND_OF_YEAR    Absolute     1 to 31,622,400
    LIB$K_DAY_OF_MONTH      Absolute     1 to 31
    LIB$K_HOUR_OF_MONTH     Absolute     1 to 744
    LIB$K_MINUTE_OF_MONTH   Absolute     1 to 44,640
    LIB$K_SECOND_OF_MONTH   Absolute     1 to 2,678,400
    LIB$K_DAY_OF_WEEK       Absolute     1 to 7
    LIB$K_HOUR_OF_WEEK      Absolute     1 to 168
    LIB$K_MINUTE_OF_WEEK    Absolute     1 to 10,080
    LIB$K_SECOND_OF_WEEK    Absolute     1 to 604,800
    LIB$K_HOUR_OF_DAY       Absolute     0 to 23
    LIB$K_MINUTE_OF_DAY     Absolute     0 to 1439
    LIB$K_SECOND_OF_DAY     Absolute     0 to 86,399
    LIB$K_MINUTE_OF_HOUR    Absolute     0 to 59
    LIB$K_SECOND_OF_HOUR    Absolute     0 to 3599
    LIB$K_SECOND_OF_MINUTE  Absolute     0 to 59
    LIB$K_JULIAN_DATE       Absolute     Julian date
    LIB$K_DELTA_WEEKS       Delta
    LIB$K_DELTA_DAYS        Delta
    LIB$K_DELTA_HOURS       Delta
    LIB$K_DELTA_MINUTES     Delta
    LIB$K_DELTA_SECONDS     Delta

 resultant-time

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       write only
    mechanism:    by reference

    The external time that results from the conversion. The
    resultant-time argument is the address of an unsigned longword
    containing the result.

 input-time

    OpenVMS usage:date_time
    type:         quadword (unsigned)
    access:       read only
    mechanism:    by reference

    Optional absolute or delta time to be converted. The input-time
    argument is the address of an unsigned quadword containing the
    time. If you do not supply a value for input-time, the current
    system time is used.