compiler/clib/gmtime.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Convert a time into UTC.
   6 */
   7
   8 /*****************************************************************************
   9
  10     NAME */
  11 #include <time.h>
  12
  13         struct tm * gmtime (
  14
  15 /*  SYNOPSIS */
  16         const time_t * tt)
  17
  18 /*  FUNCTION
  19         The gmtime() function converts the calendar time tt to
  20         broken-down time representation, expressed in Coordinated Universal
  21         Time (UTC).
  22
  23         See gmtime_r() for details.
  24
  25     INPUTS
  26         tt - The time to convert
  27
  28     RESULT
  29         A statically allocated buffer with the broken down time in Coordinated
  30         Universal Time (UTC). Note that the contents of the buffer might get
  31         lost with the call of any of the date and time functions.
  32
  33     NOTES
  34         This function must not be used in a shared library or
  35         in a threaded application. Use gmtime_r() instead.
  36
  37     EXAMPLE
  38         time_t      tt;
  39         struct tm * tm;
  40
  41         // Get the time
  42         time (&tt);
  43
  44         // and convert it
  45         tm = gmtime (&tt);
  46
  47     BUGS
  48
  49     SEE ALSO
  50         time(), ctime(), asctime(), localtime()
  51
  52     INTERNALS
  53
  54 ******************************************************************************/
  55 {
  56     static struct tm tm;
  57
  58     return gmtime_r(tt, &tm);
  59 } /* gmtime */