compiler/clib/localtime_r.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Convert a time into a string, reentrant.
   6 */
   7
   8 extern long __gmtoffset;
   9
  10 /*****************************************************************************
  11
  12     NAME */
  13 #include <time.h>
  14
  15         struct tm * localtime_r (
  16
  17 /*  SYNOPSIS */
  18         const time_t * tt,
  19         struct tm * tm)
  20
  21 /*  FUNCTION
  22         Splits the system time in seconds into a structure.
  23         The members of the tm structure are:
  24
  25         \begin{description}
  26         \item {tm_sec} The number of seconds after the minute, normally in
  27                 the range 0 to 59, but can be up to 61 to allow for leap
  28                 seconds.
  29
  30         \item{tm_min} The number of minutes after the hour, in the range 0
  31                 to 59.
  32
  33         \item{tm_hour} The number of hours past midnight, in the range 0 to
  34                 23.
  35
  36         \item{tm_mday} The day of the month, in the range 1 to 31.
  37
  38         \item{tm_mon} The number of months since January, in the range 0 to
  39                 11.
  40
  41         \item{tm_year} The number of years since 1900.
  42
  43         \item{tm_wday} The number of days since Sunday, in the range 0 to
  44                 6.
  45
  46         \item{tm_yday} The number of days since January 1, in the range  0
  47                 to 365.
  48
  49         \item{tm_isdst} A flag that indicates whether daylight saving time
  50                 is in effect at the time described. The value is positive
  51                 if daylight saving time is in effect, zero if it is not,
  52                 and negative if the information is not available.
  53
  54         \end{description}
  55
  56     INPUTS
  57         tt - A time in seconds from the 1. Jan 1970
  58         tm - A struct tm to store the result in
  59
  60     RESULT
  61         The pointer passed in tm.
  62
  63     NOTES
  64
  65     EXAMPLE
  66         time_t    tt;
  67         struct tm tm;
  68
  69         // Get time
  70         time (&tt);
  71
  72         // Break time up
  73         localtime_r (&tt, &tm);
  74
  75     BUGS
  76
  77     SEE ALSO
  78         time(), ctime_r(), asctime_r(), gmtime_r()
  79
  80     INTERNALS
  81
  82 ******************************************************************************/
  83 {
  84     time_t ti = *tt;
  85
  86     ti -= __gmtoffset * 60;
  87
  88     return gmtime_r (&ti, tm);
  89 } /* localtime_r */