jquery-timeago

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

Usage

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
timeago
and a
datetime
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
time
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

update
function with a new ISO8601 timestamp of
Date
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

locales
directory.

Settings

cutoff
: Return the original date if time distance is older than

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

Changes

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

Author

Ryan McGeary (@rmm5t)

License

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.