Tiny library to get timezone offsets for a place and time
npm install get-timezone-offsetgetTimezoneOffset is a tiny library ( less than 1k ) for getting timezone offsets.
It returns the timezone offset in minutes for any IANA timezone name for any date in the past, present and future.
It runs in any browsers or on the server, it's very small, very fast and has no dependencies[^1]
var now = new Date();
getTimezoneOffset( 'America/New_York', now ); // returns 300
getTimezoneOffset( 'Antarctica/Davis', now ); // return -420
getTimezoneOffset is tiny and fast because it ships _without a database of timezones_, using the tz database of the underlying operating system via the global Intl object.
Internationalization was introduced in 2012; Engine support is tracked here , but boils down to;
* Node: v4+
* Bun, Deno and other javascript runtimes
* All browsers
The tests will validate the library functionality _and_ the javascript engine's implementation of Intl.DateTimeFormat ( _and_ the operating systems tzinfo database ).
To test in node
npm test
To test in a browser
npm run test:browser
Then open test.html in a browser and view the console output.
[^1]: If you are running getTimezoneOffset on the server and using alpine or other ultra minimal docker image without a timezone database, you need to install the tzdata package. Most docker images, including the "slim" images publishd by node already include tzdata.
Results for locations that experience daylight saving change throughout the year
Results for locations that https://data.iana.org/time-zones/tzdb/NEWS may vary as the tz database is modified. This sometimes includes retrospective changes.