# About

Whenever a new Time Zone Database is released it could mean a huge pain for you and your users. This utilities allow you to get the ranges of affected dates when that happens; so your system may automatically migrate that data or ask your users what is the right thing to do.

# Implementing this in your own software

Please read the full documentation for your language:

• the a0-tzmigration-ruby gem, for Ruby.
• the a0-tzmigration-js package, for JavaScript.

And this important thing:

• the format of our tzdb version repository, from which each package gets the data to calculate changes between tzdb releases.

# Try it!

Use our Demo app, or just play with the javascript package here in your browser:

# Time can be really complicated in computers

If you are new to the issues of handling correctly time in software, please read the following:

• About time and computers for an introductory post to some of the nuances (13 min read).

# Opensource

Please note this is an effort from normal people, like you.

The current version of the database or software packages could have bugs. Or errors could be present in our JSON repository, which is generated from the tzinfo-data ruby gem; which have versions 2013c onwards and calculates timezone transitions up to 50 years from now (currently ≈ 2068).

THIS SOFTWARE IS CURRENTLY IN BETA, USE WITH CAUTION, DOUBLE CHECK EVERYTHING BEFORE APPLYING CHANGES TO YOUR SYSTEMS

Bug reports, corrections and suggestions are welcome in our github issues page.