Repository files navigation

Timeago is a jQuery plugin that makes it easy to support automatically updatingfuzzy timestamps (e.g. "4 minutes ago" or "about 1 day ago") from ISO 8601formatted dates and times embedded in your HTML (à la microformats).

First, load jQuery and the plugin:

<scriptsrc="jquery.min.js"type="text/javascript"></script><scriptsrc="jquery.timeago.js"type="text/javascript"></script>

Now, let's attach it to your timestamps on DOM ready - put this in the headsection:

<scripttype="text/javascript">jQuery(document).ready(function(){$("time.timeago").timeago();});</script>

This will turn all<time> elements with a class oftimeago and adatetime attribute formatted according to theISO 8601 standard:

<timeclass="timeago"datetime="2011-12-17T09:24:17Z">December 17, 2011</time>

into something like this:

<timeclass="timeago"datetime="2011-12-17T09:24:17Z"title="December 17, 2011">about 1 day ago</time>

<abbr> elements (or any other HTML elements) are also supported (this is forlegacy microformat supportand was originally supported by the library before thetime element wasintroduced to HTML5):

<abbrclass="timeago"title="2011-12-17T09:24:17Z">December 17, 2011</abbr>

As time passes, the timestamps will automatically update.

If you want to update a timestamp programatically later, call theupdatefunction with a new ISO8601 timestamp ofDate object. For example:

$("time#some_id").timeago("update","2013-12-17T09:24:17Z");// or$("time#some_id").timeago("update",newDate());

For more usage and examples:http://timeago.yarp.com/

For different language configurations: visit thelocales directory.

cutoff : Return the original date if time distance is older thancutoff (miliseconds).

// Display original dates older than 24 hoursjQuery.timeago.settings.cutoff=1000*60*60*24;

Ryan McGeary (@rmm5t)

MIT License