compiler/stdc/localtime.c

   1 /*
   2     Copyright © 1995-2013, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Convert a time into a string.
   6 */
   7
   8 #include "__stdc_intbase.h"
   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         Resulting tm struct is buffered per stdc.library and shared
  35         with gmtime().
  36
  37
  38     EXAMPLE
  39         time_t      tt;
  40         struct tm * tm;
  41
  42         // Get time
  43         time (&tt);
  44
  45         // Break time up
  46         tm = localtime (&tt);
  47
  48     BUGS
  49
  50     SEE ALSO
  51         time(), ctime(), asctime(), gmtime()
  52
  53     INTERNALS
  54
  55 ******************************************************************************/
  56 {
  57     struct StdCIntBase *StdCBase = (struct StdCIntBase *)__aros_getbase_StdCBase();
  58
  59     return localtime_r (tt, &StdCBase->tmbuffer);
  60 } /* localtime */