compose-time-toggle
v1.1.1
Published
Click to toggle all time elements between relative, local, and UTC timestamps.
Downloads
12
Readme
Time Toggle
Toggle time elements between relative (1 minute), local, and UTC timestamps.
Whenever a page loads (or a page:chage
event is fired) all time
elements with classname time-toggle
will display relative "time ago" timestamps.
A time stamp like this:
<time class="time-toggle" datetime="2016-04-21T18:51:53+00:00"></time>
Will be converted to relative time:
<time class="time-toggle" datetime="2016-04-21T18:51:53+00:00" title="toggle time">
<span class="time-toggle-date timeago" data-mode="timeago">2 weeks</span>
</time>
When clicked (in a browser in Central US time) all time stamps on the page will display their Central US timestamp.
<time class="time-toggle" datetime="2016-04-21T18:51:53+00:00" title="toggle time">
<span class="time-toggle-date local" data-mode="local">
<span class="date">2016-04-21</span> <span class="time">13:51:53</span> <span class="timezone">CDT</span>
</span>
</time>
When clicked again all timestamps on the page will display their UTC timestamp.
<time class="time-toggle" datetime="2016-04-21T18:51:53+00:00" title="toggle time">
<span class="time-toggle-date utc" data-mode="utc">
<span class="date">2016-04-21</span> <span class="time">18:51:53</span> <span class="timezone">UTC</span>
</span>
</time>
Clicking a third time will restore the relative timestamp.
Options
You can specify which timezone mode you'd like to start with by setting the data-mode
attribute. The options are:
data-mode='timeago'
- (default) Relative time.data-mode='local'
- Display local time (based on browser settings).data-mode='utc'
- Display as UTC time.
You can also change the relative time style.
data-timeago='short'
-2d
data-timeago='normal'
-2 days
(default)data-timeago='long'
-2 days ago