Learn about our RFC process, Open RFC meetings & more.Join in the discussion! »

thenceforth

0.2.1 • Public • Published

Thenceforth

Parse Date() to human readable time messages

Other time libraries dealing with "time since" or "time ago" do not have a limit on when to switch from a date sentence to a formatted date. This tiny (1.4k uncompressed ) library returns the human readable date sentence up to one month ago, where it returns either the base form mm/dd/yyyy or the pretty form 'Day Month day, Year'

Install

$ npm i thenceforth
$ yarn add thenceforth

Example

Times are parsed to when they happened in a day:

thenceforth(new Date())
// => Just now
 
const twentyMinutes = 60000 * 20
thenceforth(new Date().getTime() - twentyMinutes)
// => 20 minutes ago
 

While times greater than one month are returned as a date:

 
thenceforth(new Date('2010-10-11T00:00:00+05:30')))
// => 'Monday November 1, 2010'
 

The full form date is much easier to understand than "one year ago", as one year could be any month within 10-14 months ago. Also the day is not provided with "one year ago", and "five years ago" does not make sense for date specific events.

Install

npm i thenceforth

DownloadsWeekly Downloads

48

Version

0.2.1

License

MIT

Unpacked Size

4.49 kB

Total Files

4

Last publish

Collaborators

  • avatar