VMS Help
DECdts, utc_vmsanytime

 *Conan The Librarian

    Converts a binary timestamp to a binary OpenVMS format time.
    The TDF encoded in the input timestamp determines the TDF of the
    output.

    Format

      #include <utc.h>

      int utc_vmsanytime(*timadr, *utc)

         const utc_t *utc;
         long *timadr;

  1 - Parameters

    Input

 *utc

    Binary timestamp.

    Output

 *timadr

    Binary OpenVMS format time.

  2 - Description

    The VMS Any Time routine converts a UTC-based binary timestamp
    to a 64-bit binary time in the OpenVMS (Smithsonian) format.
    Because the input and output values are based on different time
    standards, any input representing a value before the Smithsonian
    base time of November 17, 1858 returns an error.

  3 - Returns

     0   Indicates that the routine executed successfully.
    -1   Indicates an invalid time argument or invalid results.

  4 - Example

    See the sample program for the mkvmsanytime routine.

  5 - Related Functions

    Function: utc_mkvmsanytime
  Close     Help