fromNow
An extremely lightweight javascript utility for calculating readable time differences from now and past or future dates.
Usage
fromNow.js only has 1 required parameter, a date string.
Basic Structure
2012-02-12 14:02:472014-12-21 14:02:47
Default Usage
Yields all, absolute values
; // "2 years, 8 months, 22 days, 7 hours, 39 minutes"; // "2 months, 16 hours, 17 minutes"
Limit Return Size
; // "2 years, 8 months, 22 days"; // "2 months, 16 hours"; // "2 months"
Indicate Past Tense
; // "2 years, 8 months, 22 days ago"
Include 'and' in Return
; // "2 years, 8 months, and 22 days ago"; // "2 years ago"; // "2 months and 16 hours"
Parameters
date
Type: string. Required.
Date string to be calculated.
maxChunks
Type: Integer. Optional. Default: all
Limits the returned string to contain # of not-null segments. Gathers largest to smallest.
Eg: 1 month, 0 hours, 57 minutes
limited to 2 chunks returns 1 month, 57 minutes
useAgo
Type: Boolean. Optional. Default: false
If given date occured before current datetime, append 'ago'
to returned string.
Eg: 3 months, 16 minutes
vs 3 months, 16 minutes ago
useAnd
Type: Boolean. Optional. Default: false
If true, will add 'and'
between penultimate and ultimate chunks.
Eg: 1 year, 4 hours, 16 minutes
vs 1 year, 4 hours, and 16 minutes
Eg: 2 days, 12 hours
vs 2 days and 12 hours
MIT license
fromNow.js is released under the MIT license.