/jquery-age

Age is a jQuery plugin that formats and tracks dates and times as human readable text.

Primary LanguageCoffeeScriptMIT LicenseMIT

jQuery Age

Age is a jQuery plugin that formats and tracks dates and times as human readable text.

Installation

To install copy the javascripts directories into your project and add the following snippet to the header:

<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.0.2/jquery.min.js" type="text/javascript"></script>
<script src="javascript/jquery.age.js" type="text/javascript"></script>

This plugin is also registered under http://bower.io/ to simplify integration. Try:

npm install -g bower
bower install gridly

Examples

Setting up a date or time is easy. The following snippet is a good start:

<time datetime="2010-01-01T12:00:00Z" class="age">January 1, 2010 12:00</time>
<time datetime="2020-01-01T12:00:00Z" class="age">January 1, 2020 12:00</time>

<script type="text/javascript">
  $('.age').age();
</script>

Configuration

Age supports a number of configuration settings for customizing the language and intervals:

$('.age').age({
  interval: 10000,
  suffixes: {
    past: "ago",
    future: "until",
    },
  formats: {
    now: "now"
    singular: {
      seconds: "a second",
      minutes: "a minute",
      hours: "an hour",
      days: "a day",
      weeks: "a week",
      months: "a month",
      years: "a year",
      },
    plural: {
      seconds: "{{amount}} seconds",
      minutes: "{{amount}} minutes",
      hours: "{{amount}} hours",
      days: "{{amount}} days",
      weeks: "{{amount}} weeks",
      months: "{{amount}} months",
      years: "{{amount}} years",
      },
    },
  });

);

Contributors

  • Carlos Manuel Escalona Villeda

Status

Status

Copyright

Copyright (c) 2013 - 2013 Kevin Sylvestre. See LICENSE for details.