A tiny JavaScript library that converts milliseconds to and from CSS time.

• Why would I want that?
• How tiny is it?
• How do I install it?
• How do I use it?
  • Loading the library
  • Calling the exported functions
    • from (string)
    • to (number)
• Where can I use it?
• How do I set up the build environment?
• What license is it released under?

Converting to and from CSS time is really not difficult. But this library saves you the bother of making sure you get it right and is well-supported by unit tests. It's one less thing to worry about, right? :)

1.4 kb unminified with comments, 0.5 kb minified, 0.3 kb minified + gzipped

If you're using npm:

npm install css-time --save

Or if you just want the git repo:

git clone [email protected]:philbooth/css-time.js.git

If you're into other package managers, it is also available from Bower, Component and Jam.

If you are running in Node.js, Browserify or another CommonJS-style environment, you can require check-types like so:

var check = require('css-time');

It also the supports the AMD-style format preferred by Require.js.

If you are including css-time.js with an HTML <script> tag, or neither of the above environments are detected, it will export the interface globally as cssTime.

Two functions are exported, from and to.

Returns the number of milliseconds represented by a CSS time string. If the argument can't be parsed as a CSS time, an error is thrown.

cssTime.from('500ms'); // returns 500
cssTime.from('-1.5s'); // returns -1500

Returns a CSS time string representing the number of milliseconds passed in the argument. If the argument is not a number, an error is thrown.

cssTime.to(500); // returns '500ms'
cssTime.to(-0.5); // returns '-0.5ms'

The code is all written in ES3 syntax, so works in any browser.

The build environment relies on Node.js, NPM, JSHint, Mocha, Chai and UglifyJS. Assuming that you already have Node.js and NPM set up, you just need to run npm install to install all of the dependencies as listed in package.json.

The unit tests are in test/css-time.js. You can run them with the command npm test. To run the tests in a browser, open test/css-time.html.

MIT