![](\"http://i.giphy.com/DluPT7dZ0uXg4.gif\")
\n\n\n A tiny module for human readable timespans.\n
\n\n[](https://travis-ci.org/danasilver/tiny-human-time)\n\n## API\n\n### `humanize(t1, t2 [, units])`\n\nWhat you get when you `require('tiny-human-time')`.\n\n`t1` and `t2` are instances of `Date` or integers whose value relative to one\nanother is given in milliseconds. Their order doesn't matter.\n\nIf `t2` is not given, `t1` alone will be used as the timespan relative to 0.\n\nEither argument can be an array of the form `[seconds, nanoseconds]`, like\nthat produced by\n[process.hrtime()](https://nodejs.org/api/process.html#process_process_hrtime).\n\nAn optional last argument, `units` has possible values `short` and `long`,\ndefaulting to `long`. `units` can be given as the last argument even if\n`t2` is not given.\n\nReturns the converted value and the greatest matching unit\nwithout going over. For example, `23 hours` will be followed by `1 day`.\n\n### `humanize.short(t1, t2)`\n\nA convenience method to use `short` units. The possible arguments for `t1` and\n`t2` are the same as `humanize`.\n\n## Supports:\n\n - nanoseconds\n - microseconds\n - milliseconds\n - seconds\n - minutes\n - hours\n - days\n - weeks\n - years\n\n## Usage\n\n```js\nconst humanize = require('tiny-human-time');\n\nconst now = new Date(2016, 3, 5);\nconst later = new Date(2016, 3, 6);\n\nhumanize(now, later);\n// => 1 day\n```\n\n```js\nconst humanize = require('tiny-human-time');\n\nconst start = process.hrtime()\n// and then a miracle occurs\nconst elapsed = process.hrtime(start)\n\nhumanize(elapsed)\n// => 23 microseconds\n```\n\n```js\nconst humanize = require('tiny-human-time').short;\n\nhumanize(1)\n// => 1ms\n```\n","maintainers":[{"name":"danasilver","email":"dsilver1221@gmail.com"}],"time":{"modified":"2022-06-27T06:59:05.489Z","created":"2016-03-05T15:39:56.479Z","1.0.0":"2016-03-05T15:39:56.479Z","1.1.0":"2016-03-06T00:59:10.599Z","1.2.0":"2016-03-06T19:38:30.793Z"},"homepage":"https://github.com/danasilver/tiny-human-time#readme","keywords":["tiny","time","humanize","human","timespan","timedelta"],"repository":{"type":"git","url":"git+https://github.com/danasilver/tiny-human-time.git"},"author":{"name":"Dana Silver","email":"dsilver1221@gmail.com","url":"http://www.danasilver.org"},"bugs":{"url":"https://github.com/danasilver/tiny-human-time/issues"},"license":"MIT","readmeFilename":"README.md","contributors":[{"name":"Tristan Davies","email":"github@tristan.io"}]}