Timeago is a jQuery plugin that makes it easy to support automatically updating fuzzy timestamps (e.g. "4 minutes ago").
This repository has been archived on 2025-05-04. You can view files and clone it, but you cannot make any changes to it's state, such as pushing and creating new issues, pull requests or comments.
Find a file
Brian Corrigan 0dda6d92a1 Adds AMD wrapper
This is handy for working with RequireJS setups that use jQuery in noConflict mode.  Without it this plugin continually tries to access the global object.
2013-01-18 22:26:07 -05:00
locales fix japanese locale more formally 2012-12-15 14:23:16 +09:00
test Interpret null wordSeparator as empty string 2012-12-27 15:37:26 +00:00
vendor/cache Updated rake tasks to automatically compile CoffeeScript 2011-09-23 16:59:49 -04:00
.gitignore Updated rake tasks to automatically compile CoffeeScript 2011-09-23 16:59:49 -04:00
clock.png first version 2008-07-18 11:34:13 -04:00
CNAME Added GitHub Pages support 2009-07-17 13:43:44 -04:00
Gemfile Updated rake tasks to automatically compile CoffeeScript 2011-09-23 16:59:49 -04:00
Gemfile.lock Updated rake tasks to automatically compile CoffeeScript 2011-09-23 16:59:49 -04:00
index.html Added link to the list of sites that use timeago 2012-08-16 13:34:17 -04:00
jquery.timeago.js Adds AMD wrapper 2013-01-18 22:26:07 -05:00
public Public symlink for easier pow.cx linkage 2011-12-14 09:16:52 -05:00
Rakefile Fixed rakefile 2011-09-23 17:03:13 -04:00
README.markdown Corrected December spelling in readme 2012-05-10 09:57:34 +10:00

timeago: a jQuery plugin

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).

Usage

First, load jQuery and the plugin:

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

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

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

This will turn all abbr elements with a class of timeago and an ISO 8601 timestamp in the title (conforming to the datetime design pattern microformat):

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

into something like this:

<abbr class="timeago" title="December 17, 2011">about 1 day ago</abbr>

HTML5 <time> elements are also supported:

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

As time passes, the timestamps will automatically update.

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

For different language configurations: visit the locales directory.

Author

Ryan McGeary (@rmm5t)

Other

MIT License

Copyright (c) 2008-2012, Ryan McGeary (ryan -[at]- mcgeary [dot] org)