Twix.js
Twix is a comprehensive JS library for working with date ranges, and includes a customizable smart formatter. It's written in CoffeeScript and it depends on Moment.js.
Some examples:
var t = ; t; //=> Jan 25, 1982, 9:30 AM - 1:30 PM t; //=> truet; //=> "4 hours"t; //=> 1t; //=> another range
See the documentation for more.
Documentation
You can find comprehensive docs here:
Breaking change in 1.0.0: Removed the deprecated showYear
and showDate
smart formatter options. Use hideYear
, hideDate
, implicitYear
, and implicitDate
instead.
Building
If you want to build and test Twix for yourself, make
wraps everything you need:
Command | Function |
---|---|
make configure |
Install dependencies (same as npm install ) |
make or make build |
Compile src/*.coffee to dist/*.js |
make test |
Run Mocha suite |
make lint |
Linter |
make bench |
Microbenchmarks |
Contributing
Patches are welcome!
- Don't include your changes to the generated
.js
files in the patch; they're much harder to merge. I'll generate them when I cut the release. - Make sure you run the linter and the tests before submitting a PR. Use
make lint
andmake test
. - If you make a change that will need documentation, make the appropriate update to docs. It will get published to the website on the next release.
Changelog
Copyright and License
Copyright 2012-2015 Isaac Cambron and contributors. Distributed under the MIT License. See LICENSE for details.