<time> element is only rendered in one timezone, it is ideal for caching.
<%= local_time(comment.created_at) # comment.created_at => Wed, 27 Nov 2013 18:43:22 EST -0500 %>
<time data-format="%B %e, %Y %l:%M%P" data-local="time" datetime="2013-11-27T23:43:22Z">November 27, 2013 11:43pm</time>
When the DOM loads, the content is immediately replaced with a local, formatted time:
<time data-format="%B %e, %Y %l:%M%P" data-local="time" datetime="2013-11-27T23:43:22Z" data-localized="true">November 27, 2013 6:43pm</time>
(Line breaks added for readability)
Pass a time and an optional strftime format (default format shown here) <%= local_time(time, format: '%B %e, %Y %l:%M%P') %> Alias for local_time with a month-formatted default <%= local_date(time, format: '%B %e, %Y') %>
To use a strftime format already defined in your app, pass a symbol as the format.
<%= local_time(date, format: :long) %>
Date::DATE_FORMATS[format] will be scanned (in that order) for your format.
%a %A %b %B %c %d %e %H %I %l %m %M %p %P %S %w %y %Y
<%= local_time_ago(time) %>
Displays the relative amount of time passed. With age, the descriptions transition from specific quantities to general dates. The
<time> elements are updated every 60 seconds. Examples (in quotes):
- Recent: "a second ago", "32 seconds ago", "an hour ago", "14 hours ago"
- Yesterday: "yesterday at 5:22pm"
- This week: "Tuesday at 12:48am"
- This year: "on Nov 17"
- Last year: "on Jan 31, 2012"
gem 'local_time'to your Gemfile.
DOMContentLoaded event to run initially. It also listens on
page:update if you're using Turbolinks and
ajaxSuccess if you're using jQuery. This should catch most cases where new
<time> elements have been added to the DOM and process them automatically. If you're adding new elements in another context, trigger
time:elapse to process them.
relativeTimeAgo are available via the global
> LocalTime.strftime(new Date, "%B %e, %Y %l:%M%P") "February 9, 2014 12:55pm" > LocalTime.relativeTimeAgo(new Date(new Date - 60 * 1000 * 5)) "5 minutes ago"
0.3.0 (February 9, 2014)
- Allow :format option lookup in I18n or DATE_FORMATS hashes [Paul Dobbins]
0.2.0 (December 10, 2013)
innerTextfor Firefox compatibility
0.1.0 (November 29, 2013)
- Initial release.