git.roojs.org Git - web.mtrack/blob - js/jquery.timeago.js

   1 /*
   2  * timeago: a jQuery plugin, version: 0.8.2 (2010-02-16)
   3  * @requires jQuery v1.2.3 or later
   4  *
   5  * Timeago is a jQuery plugin that makes it easy to support automatically
   6  * updating fuzzy timestamps (e.g. "4 minutes ago" or "about 1 day ago").
   7  *
   8  * For usage and examples, visit:
   9  * http://timeago.yarp.com/
  10  *
  11  * Licensed under the MIT:
  12  * http://www.opensource.org/licenses/mit-license.php
  13  *
  14  * Copyright (c) 2008-2010, Ryan McGeary (ryanonjavascript -[at]- mcgeary [*dot*] org)
  15  */
  16 (function($) {
  17   $.timeago = function(timestamp) {
  18     if (timestamp instanceof Date) return inWords(timestamp);
  19     else if (typeof timestamp == "string") return inWords($.timeago.parse(timestamp));
  20     else return inWords($.timeago.datetime(timestamp));
  21   };
  22   var $t = $.timeago;
  23
  24   $.extend($.timeago, {
  25     settings: {
  26       refreshMillis: 60000,
  27       allowFuture: false,
  28       strings: {
  29         prefixAgo: null,
  30         prefixFromNow: null,
  31         suffixAgo: "ago",
  32         suffixFromNow: "from now",
  33         ago: null, // DEPRECATED, use suffixAgo
  34         fromNow: null, // DEPRECATED, use suffixFromNow
  35         seconds: "less than a minute",
  36         minute: "about a minute",
  37         minutes: "%d minutes",
  38         hour: "about an hour",
  39         hours: "about %d hours",
  40         day: "a day",
  41         days: "%d days",
  42         month: "about a month",
  43         months: "%d months",
  44         year: "about a year",
  45         years: "%d years"
  46       }
  47     },
  48     inWords: function(distanceMillis) {
  49       var $l = this.settings.strings;
  50       var prefix = $l.prefixAgo;
  51       var suffix = $l.suffixAgo || $l.ago;
  52       if (this.settings.allowFuture) {
  53         if (distanceMillis < 0) {
  54           prefix = $l.prefixFromNow;
  55           suffix = $l.suffixFromNow || $l.fromNow;
  56         }
  57         distanceMillis = Math.abs(distanceMillis);
  58       }
  59
  60       var seconds = distanceMillis / 1000;
  61       var minutes = seconds / 60;
  62       var hours = minutes / 60;
  63       var days = hours / 24;
  64       var years = days / 365;
  65
  66       var words = seconds < 45 && substitute($l.seconds, Math.round(seconds)) ||
  67         seconds < 90 && substitute($l.minute, 1) ||
  68         minutes < 45 && substitute($l.minutes, Math.round(minutes)) ||
  69         minutes < 90 && substitute($l.hour, 1) ||
  70         hours < 24 && substitute($l.hours, Math.round(hours)) ||
  71         hours < 48 && substitute($l.day, 1) ||
  72         days < 30 && substitute($l.days, Math.floor(days)) ||
  73         days < 60 && substitute($l.month, 1) ||
  74         days < 365 && substitute($l.months, Math.floor(days / 30)) ||
  75         years < 2 && substitute($l.year, 1) ||
  76         substitute($l.years, Math.floor(years));
  77
  78       return $.trim([prefix, words, suffix].join(" "));
  79     },
  80     parse: function(iso8601) {
  81       var s = $.trim(iso8601);
  82       s = s.replace(/-/,"/").replace(/-/,"/");
  83       s = s.replace(/T/," ").replace(/Z/," UTC");
  84       s = s.replace(/([\+-]\d\d)\:?(\d\d)/," $1$2"); // -04:00 -> -0400
  85       return new Date(s);
  86     },
  87     datetime: function(elem) {
  88       // jQuery's `is()` doesn't play well with HTML5 in IE
  89       var isTime = $(elem).get(0).tagName.toLowerCase() == "time"; // $(elem).is("time");
  90       var iso8601 = isTime ? $(elem).attr("datetime") : $(elem).attr("title");
  91       return $t.parse(iso8601);
  92     }
  93   });
  94
  95   $.fn.timeago = function() {
  96     var self = this;
  97     self.each(refresh);
  98
  99     var $s = $t.settings;
 100     if ($s.refreshMillis > 0) {
 101       setInterval(function() { self.each(refresh); }, $s.refreshMillis);
 102     }
 103     return self;
 104   };
 105
 106   function refresh() {
 107     var data = prepareData(this);
 108     if (!isNaN(data.datetime)) {
 109       $(this).text(inWords(data.datetime));
 110     }
 111     return this;
 112   }
 113
 114   function prepareData(element) {
 115     element = $(element);
 116     if (!element.data("timeago")) {
 117       element.data("timeago", { datetime: $t.datetime(element) });
 118       var text = $.trim(element.text());
 119       if (text.length > 0) element.attr("title", text);
 120     }
 121     return element.data("timeago");
 122   }
 123
 124   function inWords(date) {
 125     return $t.inWords(distance(date));
 126   }
 127
 128   function distance(date) {
 129     return (new Date().getTime() - date.getTime());
 130   }
 131
 132   function substitute(stringOrFunction, value) {
 133     var string = $.isFunction(stringOrFunction) ? stringOrFunction(value) : stringOrFunction;
 134     return string.replace(/%d/i, value);
 135   }
 136
 137   // fix for IE6 suckage
 138   document.createElement("abbr");
 139   document.createElement("time");
 140 })(jQuery);