ggmmttiimmee() -- Time Function (libc)

Convert system time to calendar structure
#iinncclluuddee <ttiimmee.hh>
#iinncclluuddee <ssyyss/ttyyppeess.hh>
ttmm *ggmmttiimmee(_t_i_m_e_p)
ttiimmee_tt *_t_i_m_e_p;

ggmmttiimmee() converts the internal  time from seconds since midnight January 1,
1970 GMT, into fields that give integer years since 1900, the month, day of
the  month, the  hour, the  minute, the  second, the day  of the  week, and
yearday.  It  returns a  pointer to the  structure ttmm, which  defines these
fields, and which  is itself defined in the header  file ttiimmee.hh. Unlike its
cousin, llooccaallttiimmee(), ggmmttiimmee() returns Greenwich Mean Time (GMT).

_E_x_a_m_p_l_e
For an example of how to use this function, see aassccttiimmee().

_S_e_e _A_l_s_o
GGMMTT, lliibbcc, llooccaallttiimmee(), ttiimmee [oovveerrvviieeww], TTIIMMEEZZOONNEE
ANSI Standard, section 7.12.3.3
POSIX Standard, section 8.1

_N_o_t_e_s
ggmmttiimmee()  returns a  pointer to  a statically allocated  data area  that is
overwritten by successive calls.
