by rmm5t

:clock8: The original jQuery plugin that makes it easy to support automatically updating fuzzy times...

3.8K Stars 720 Forks Last release: over 1 year ago (v1.6.7) MIT License 492 Commits 49 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

timeago: a jQuery plugin

NPM Bower

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


First, load jQuery and the plugin:

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

This will turn all

elements with a class of
and a
attribute formatted according to the ISO 8601 standard:

into something like this:

elements (or any other HTML elements) are also supported (this is for legacy microformat support and was originally supported by the library before the
element was introduced to HTML5):
December 17, 2011

As time passes, the timestamps will automatically update.

If you want to update a timestamp programatically later, call the

function with a new ISO8601 timestamp of
object. For example:
$("time#some_id").timeago("update", "2013-12-17T09:24:17Z");
// or
$("time#some_id").timeago("update", new Date());

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

For different language configurations: visit the



: Return the original date if time distance is older than

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


| Version | Notes | |---------|---------------------------------------------------------------------------------| | 1.6.x | (compare) Wraped locales in UMD wrappers; locale improvements | | 1.5.x | (compare) Added Date as argument to update function; locales | | 1.4.x | (compare) Added allowPast setting; locale updates | | 1.3.x | (compare) Added updateFromDOM function; bug fixes; bower support | | 1.2.x | (compare) Added cutoff setting; locale updates | | 1.1.x | (compare) Added update function; locale updates | | 1.0.x | (compare) locale updates; bug fixes; AMD wrapper | | 0.11.x | (compare) natural rounding; locale updates; | | 0.10.x | (compare) locale updates | | 0.9.x | (compare) microsecond support; bug fixes | | 0.8.x | (compare)

element support; bug fixes | | 0.7.x | (compare) locale function overrides; unit tests | | ... | ... |


Ryan McGeary (@rmm5t)


MIT License

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.