This is a little module that allows you to look up the current time zone of a
location, given it's latitude and longitude. I wrote it because the existing
Node module that does this (
tzwhere) was far too slow to be useful in a
production setting. This module attempts to ameliorate that.
npm install tz-lookup
> var tz = require("tz-lookup"); > console.log(tz(42.7235, -73.6931)); "America/New_York"
Please take note of the following:
- The exported function call will throw an error if the latitude or longitude provided are NaN or out of bounds. Otherwise, it will never throw an error and will always return an IANA timezone database string. (Barring bugs.)
- The exported function call is synchronous. Previous versions of this module were asynchronous, due to the timezone database being too large to conveniently fit in memory. Thanks to very careful data compression, this is no longer the case.
- The timezones returned by this module are approximate: since the timezone database is so large, lossy compression is necessary for fast lookups. In particular, the compression used may be of insufficient resolution for several very small timezones (such as Europe/Vatican) and favors country timezones over GMT offsets (and so may exaggerate the distance of territorial waters). However, the level of accuracy should be adequate for most purposes. (For example, this module is used by the Forecast API for global timezone lookups.)
If you find a real-world case where this module's accuracy is inadequate, please open an issue (or, better yet, submit a pull request with a failing test) and I'll see what I can do to increase the accuracy for you.
Timezone data is from Eric Muller's excellent TZ timezone maps. To
regenerate the compressed database, simply download his
convert it to a GeoJSON using GDAL, put it in the project directory (with the
tz_world.json), and run
json2bin >tz.bin. The timezone database was
last updated on 26 Nov 2013.
To the extend possible by law, The Dark Sky Company, LLC has waived all copyright and related or neighboring rights to this library.