compiler/clib/localtime.c

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