UNPKG

@instructure/timezone

Version:

Small, elegant, Olson educated, timezone aware date math and `strftime` date formatting in pure JavaScript with no dependendcies for Node.js and the browser. Timezone uses the Olson/IANA timezone database. Timezone is aware of every clock transition in th

62 lines (47 loc) 2.36 kB
This is a fork of (Bigeasy's Timezone library)[https://github.com/bigeasy/timezone]. The original library uses eggert/tz to generate up-to-date timezone information, but the library is not maintained anymore. This fork uses (@instructure/timezone)[https://github.com/instructure/timezone] If time zones ever get out of sync again, do the following... ```bash git clone --recurse-submodules [@instructure/timezone URL] cd timezone cd eggert/tz git checkout [Last updated version number from moment-timezone, e.g. 2023c] # update package.json version number npm install make publish # publishes to NPM git add . # commit and push git changes ``` <a href="http://www.flickr.com/photos/wolfgangstaudt/3553572933/" title="Sundial by Wolfgang Staudt, on Flickr"><img src="http://farm4.staticflickr.com/3605/3553572933_5d30ced3e7_b.jpg" alt="Sundial"></a> # Timezone [![Build Status](https://secure.travis-ci.org/bigeasy/timezone.png?branch=master)](http://travis-ci.org/bigeasy/timezone) Format time in JavaScript using the IANA time zone database. (Photo: Sundial by [Wolfgang Staudt](http://www.flickr.com/people/wolfgangstaudt/).) ```javascript var tz = require('timezone/loaded'), equal = require('assert').equal, utc; // Get POSIX time in UTC. utc = tz('2012-01-01'); // Convert UTC time to local time in a localize language. equal(tz(utc, '%c', 'fr_FR', 'America/Montreal'), 'sam. 31 déc. 2011 19:00:00 EST'); ``` A full-featured time zone aware date formatter for JavaScript. * **Timezone** is a MicroJS library in pure JavaScript with no dependencies that provides timezone aware date math and date formatting. * **Timezone** uses the IANA Database to determine the correct wall clock time anywhere in the world for any time since the dawn of standardized time. * **Timezone** formats dates with a full implementation of `strftime` formats, including the GNU `date` extensions. * **Timezone** represents time in POSIX time and local time using RFC 3999 date strings. * **Timezone** is a full featured standards based time library in pure JavaScript for under 3K minified and gzipped. ## Hacking ```console $ git clone --quiet https://github.com/bigeasy/timezone.git $ cd timezone && make && npm install && npm test ``` ## License The [MIT License](https://raw.github.com/bigeasy/timezone/master/LICENSE).