evalEmpire / y2038

Fix time.h on 32 bit machines to work past the year 2038 bug
https://github.com/schwern/y2038/wiki
MIT License
114 stars 24 forks source link

This is an implementation of POSIX time.h which solves the year 2038 bug on systems where time_t is only 32 bits. It is implemented in bog-standard ANSI C. The latest version can be found at https://github.com/evalEmpire/y2038

It makes use of the system's native 32 bit functions to perform time zone and daylight savings time calculations and thus does not need to ship its own time zone table.

Here is a list of the currently implemented functions in time64.h and their POSIX time.h equivalents.

time64.h time.h


localtime64_r localtime_r localtime64 localtime gmtime64_r gmtime_r gmtime64 gmtime asctime64_r asctime_r asctime64 asctime ctime64_r ctime_r ctime64 ctime timelocal64 mktime mktime64 mktime timegm64 timegm (a GNU extension)

To install, simply copy time64.c and time64.h into your project and make use of the functions.

To test, run "make test". You must have Perl, prove (which comes with a recent version of the Test::Harness Perl module) and bzdiff installed to run the full test suite. It will do a number of unit tests, plus test against a large table of known good values in different time zones.

Limitations, Issues, etc...

localtime64_r() gets its time zone and daylight savings time information by mappping the future year back to a similar one between 2010 and 2037, safe for localtime_r(). The calculations are accurate according to current time zone and daylight savings information, but may become inaccurate if a change is made that takes place after 2010. But its better to be off by an hour than 137 years.

Future versions will probe for a 64 bit safe system localtime_r() and gmtime_r() and use that. You can manually set the safe range of your system in time64_config.h.

The maximum date is still limited by your tm struct. Most 32 bit systems use a signed integer tm_year which means the practical upper limit is the year 2147483647 which is somewhere around 2**54. You can use a 64 bit clean tm struct by setting USE_TM64 in time64_config.h

Portability

I would like to add some configuration detection stuff in the future, but for now all I can do is document the assumptions...

There are a number of configuration options in time64.h.