poll tests: Avoid test failure on BSD and Solaris systems.
[gnulib.git] / doc / posix-functions / localtime.texi
blob040102b9bc9dcf32525132ac047ede3de51e84fb
1 @node localtime
2 @section @code{localtime}
3 @findex localtime
5 POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9699919799/functions/localtime.html}
7 Gnulib module: localtime
9 Portability problems fixed by Gnulib:
10 @itemize
11 @item
12 On native Windows platforms (mingw, MSVC), this function works incorrectly
13 when the environment variable @code{TZ} has been set by Cygwin.
14 @end itemize
16 Portability problems not fixed by Gnulib:
17 @itemize
18 @item
19 On some platforms, this function loops forever for values
20 near extrema (such as the year @math{-2**31}):
21 Mac OS X 10.6.
22 You can use the @code{time_rz} module to work around the problem.
23 @item
24 On some platforms, this function returns nonsense values for
25 unsupported arguments (like @math{2^56}), rather than failing:
26 FreeBSD 10.
27 @item
28 Native Windows platforms (mingw, MSVC) support only a subset of time
29 zones supported by GNU or specified by POSIX@.  @xref{tzset}.
30 @end itemize