|
|
5 years ago | |
|---|---|---|
| .. | ||
| node_modules | 5 years ago | |
| LICENSE | 5 years ago | |
| README.md | 5 years ago | |
| index.js | 5 years ago | |
| package.json | 5 years ago | |
| utils.js | 5 years ago | |
README.md
pretty-time

Easily format the time from node.js
process.hrtime. Works with timescales ranging from weeks to nanoseconds.
Install
Install with npm
$ npm i pretty-time --save
Usage
var pretty = require('pretty-time');
var start = process.hrtime();
var time = process.hrtime(start);
console.log(pretty(time));
//=> 3μs
API
By default, when no time increment is given as the second argument, the closest timescale is used (e.g. most granular without being less than zero).
Examples:
pretty([1200708, 795428088]);
//=> '2w'
pretty([800708, 795428088]);
//=> '1w'
pretty([400708, 795428088]);
//=> '5d'
pretty([70708, 795428088]);
//=> '20h'
pretty([12708, 795428088]);
//=> '4h'
pretty([3708, 795428088]);
//=> '1h'
pretty([208, 795428088]);
//=> '3m'
pretty([20, 795428088]);
//=> '21s'
pretty([0, 795428088]);
//=> '795ms'
pretty([0, 000428088]);
//=> '428μs'
pretty([0, 000000088]);
//=> '88ns'
pretty([0, 000000018]);
//=> '18ns'
Minimum time increment
(All of the following examples use [6740, 795428088] as the hrtime array.)
This value is passed as the second argument and determines how granular to make the time.
Examples
pretty(time, 'h');
//=> '2h'
pretty(time, 'm');
//=> '1h 52m'
pretty(time, 's');
//=> '1h 52m 21s'
Valid time increments
Any of the following may be used:
ns|nano|nanosecond|nanosecondsμs|micro|microsecond|microsecondsms|milli|millisecond|millisecondss|sec|second|secondsm|min|minute|minutesh|hr|hour|hoursd|day|daysw|wk|week|weeks
Related projects
- o-clock: Simple utility for displaying the time in 12-hour clock format. | homepage
- seconds: Get the number of seconds for a minute, hour, day and week. | homepage
- time-stamp: Get a formatted timestamp. | homepage
- timescale: Convert from one time scale to another. Nanosecond is the most atomic unit, week is… more | homepage
- week: Get the current week number. | homepage
- weekday: Get the name and number of the current weekday. Or get the name of the… more | homepage
- year: Simple utility to get the current year with 2 or 4 digits. | homepage
Running tests
Install dev dependencies:
$ npm i -d && npm test
Contributing
Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.
Author
Jon Schlinkert
License
Copyright © 2015 Jon Schlinkert Released under the MIT license.
This file was generated by verb-cli on October 18, 2015.