TimeSincePlugin

This plugin is inspired by the WordPress TimeSince plugin. It which can be used to display a time difference in a human readable way, for instance to tell you that a topic has been published "2 days, 3 hours ago".

There are some problems with the original TimeSince plugin for WordPress. For example, it was only able to display a time diff with at most two expressions: "1day, 2hours ago" or "1 week ago" but not "1 day, 2 hours and 3 minutes". It even displays only one time expression if the difference does not occure in two adjacent time units (time units are year, month, week, day, hour, minute). If a time interval differs in week and hour the TimeSince WP plugin will only display the week difference and not the hours as week and hour are not adjacent. This is fixed in the TimeSincePlugin for TWiki. Several other parameters have been added to give a finer control of the format and the information displayed.

Syntax Rules

%TIMESINCE%, %TIMESINCE{[[from]="..."] [to="..."]}%

Without arguments the time since the current topic has been created will be displayed.

Time expressions can be specified in any of the following format:

• 31 Dec 2001 - 23:59 (TWiki date)
• 31 Dec 2001
• 2001/12/31 23:59:59 (RCS date)
  also -, . instead of / in date, also . instead : in time
• 2001/12/31 23:59
• 2001/12/31
• 2001-12-31T23:59:59Z (ISO date)
• 2001-12-31T23:59:59+01:00
• 2001-12-31T23:59Z
• 2001-12-31T23:59+01:00
• epoch seconds

Format strings may contain the following:

• $time expands to the calculated time difference
• $percnt$ expands to a % char
• $dollar$ expands to a $ char
• $n expands to a linefeed
• $t expands to a tab space
• $nop expands to the empty string

Examples

Plugin Installation Instructions

• Download the ZIP file
• Unzip it in your twiki installation directory. Content:

  File:	Description:
  data/TWiki/TimeSincePlugin.txt	plugin topic
  lib/TWiki/Plugins/TimeSincePlugin.pm	plugin perl module
  lib/TWiki/Plugins/TimeSincePlugin/Core.pm	plugin core

• (Dakar) Visit configure in your TWiki installation, and enable the plugin in the {Plugins} section.

Plugin Info

-- TWiki:Main.MichaelDaum - 03 Jan 2008