• Stars
    star
    3,821
  • Rank 11,514 (Top 0.3 %)
  • Language
    JavaScript
  • License
    MIT License
  • Created over 16 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

🕗 The original jQuery plugin that makes it easy to support automatically updating fuzzy timestamps (e.g. "4 minutes ago").

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:

<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() {
     $("time.timeago").timeago();
   });
</script>

This will turn all <time> elements with a class of timeago and a datetime attribute formatted according to the ISO 8601 standard:

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

into something like this:

<time class="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 for legacy microformat support and was originally supported by the library before the time element was introduced to HTML5):

<abbr class="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 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) <time> element support; bug fixes
0.7.x (compare) locale function overrides; unit tests
... ...

Author

Ryan McGeary (@rmm5t)

License

MIT License

More Repositories

1

strip_attributes

🔪 An ActiveModel extension that automatically strips all attributes of leading and trailing whitespace before validation. If the attribute is blank, it strips the value to nil.
Ruby
543
star
2

liquidmetal

💦🤘 A mimetic poly-alloy of the Quicksilver scoring algorithm, essentially LiquidMetal. </Schwarzenegger Voice>
JavaScript
291
star
3

dotfiles

●📄 Ryan McGeary's configuration shiznit that makes him productive
Emacs Lisp
283
star
4

jquery-flexselect

💪☑️ A jQuery plugin that turns regular select boxes into Quicksilver-like, flex-matching, incremental-finding controls.
HTML
237
star
5

jquery-sieve

🚰 Sieve is a jQuery plugin allows you to quickly add an interactive search filter to any block of content.
HTML
153
star
6

maxframe.el

↔️↕️ [Elisp] maxframe provides the ability to maximize the emacs frame and stay within the display resolution.
Emacs Lisp
52
star
7

googleapis-mirror

A subset mirror of the Google Libraries API CDN meant to be served from your local development machine when internet access is lacking.
Ruby
47
star
8

minitest-matchers_vaccine

💉 Adds matcher support to minitest without all the other RSpec-style expectation "infections."
Ruby
35
star
9

tilda-bin

〰️🗑️ Ryan McGeary's personal ~/bin directory -- well at least the stuff that he wants to make public.
Ruby
15
star
10

mkv2m4v

📺 Makes Apple TV compatible videos from MKV containers
Ruby
12
star
11

rbenv-rbx

Plugin for rbenv that adds Rubinius 2.x support
Shell
11
star
12

insert-time.el

[Elisp] insert-time provides an easy way to insert time and date stamps into your emacs buffers
Emacs Lisp
11
star
13

ryan.mcgeary.org

🤓 Ryan McGeary's Home Page
HTML
9
star
14

iso639

🌎🌏 A ruby gem for ISO 639-1 and ISO 639-2 lookups by name, alpha-2 code, or alpha-3 code
Ruby
8
star
15

smhelper-obfuscated-email

A staticmatic helper to obfuscate mailto links using javascript.
Ruby
6
star
16

yarg

Yet Another Ruby Generator: Customize existing project generators to fit your personality.
Ruby
6
star
17

rbenv-bundle-path-fix

💎🔧 Fixes a peculiar difference between local and global config of BUNDLE_PATH in Bundler v1
Shell
5
star
18

duplicatorg

Minimal command line client for ReplicatorG
Ruby
4
star
19

boulderruby-startupweek

Boulder Ruby Presentation Demo during Startup Week 2015
Ruby
4
star
20

project-euler

My solutions to Project Euler
Ruby
3
star
21

zippopotamus

📍 Ruby wrapper gem for the http://Zippopotam.us API.
Ruby
3
star
22

launch_app_scripts

Automated creation of AppleScripts that launch your favorite applications
3
star
23

mcgearygroup.com

Home page for McGeary Consulting Group, LLC
HTML
2
star
24

htmlize

Convert buffer text and decorations to HTML
Emacs Lisp
2
star
25

rmm5t.github.io

My GitHub Page (just a redirect to http://ryan.mcgeary.org)
HTML
2
star
26

sprints

Scaffolding for quick development sprints
Ruby
1
star
27

middleman-test

For testing gems related to middleman
Ruby
1
star
28

stackexchange-shortcut-disabler

🔧 Chrome Extension to fix readline/emacs hotkeys in the editor of all StackExchange sites
JavaScript
1
star
29

big4referral

HTML
1
star