compiler/clib/localtime.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Convert a time into a string.
   6 */
   7
   8 extern long __gmtoffset;
   9
  10 /*****************************************************************************
  11
  12     NAME */
  13 #include <time.h>
  14
  15         struct tm * localtime (
  16
  17 /*  SYNOPSIS */
  18         const time_t * tt)
  19
  20 /*  FUNCTION
  21         Splits the system time in seconds into a structure.
  22
  23         See localtime_r() for details.
  24
  25     INPUTS
  26         tt - A time in seconds from the 1. Jan 1970
  27
  28     RESULT
  29         A statically allocated buffer with the broken up time. Note that
  30         the contents of the buffer might get lost with the call of any of
  31         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 localtime_r() instead.
  36
  37     EXAMPLE
  38         time_t      tt;
  39         struct tm * tm;
  40
  41         // Get time
  42         time (&tt);
  43
  44         // Break time up
  45         tm = localtime (&tt);
  46
  47     BUGS
  48
  49     SEE ALSO
  50         time(), ctime(), asctime(), gmtime()
  51
  52     INTERNALS
  53
  54 ******************************************************************************/
  55 {
  56     static struct tm tm;
  57
  58     return localtime_r (tt, &tm);
  59 } /* localtime */