Returns the time (expressed as Universal Coordinated Time)
    elapsed since 00:00:00, January 1, 1970, in seconds.

    Format

      #include  <time.h>

      time_t time  (time_t *time_location);

1  –  Function Variants

    Compiling with the _DECC_V4_SOURCE and _VMS_V6_SOURCE feature-
    test macros defined enables a local-time-based entry point to the
    time function that is equivalent to the behavior before OpenVMS
    Version 7.0.

2  –  Argument

 time_location

    Either NULL or a pointer to the place where the returned time is
    also stored. The time_t type is defined in the <time.h> header
    file as follows:

    typedef unsigned long int time_t;

3  –  Return Values

    x                  The time elapsed past the Epoch.
    (time_t)(-1)       Indicates an error. If the value of
                       SYS$TIMEZONE_DIFFERENTIAL logical is wrong,
                       the function will fail with errno set to
                       EINVAL.