Table of Contents

# $EPIC: tdiff2.txt,v 1.2 2007/03/01 03:26:44 jnelson Exp $

Synopsis:

$tdiff2(<seconds>)

Technical:

If <tday> is 0, then nothing
Otherwise, then "<tday>d "
  plus
If <thour> is 0, then nothing
Otherwise, then "<thour>h "
  plus
If <tmin> is 0, then nothing
Otherwise, then "<tmin>m "
  plus
If <tsec> is not zero or all of <tday>, <thour>, <tmin> are zero,
    or <after> exists, then 
  If <after> exists, <sec> is "<tsec>.<after>"
    then "<sec> seconds"
  If <tsec> is 1, then "<sec>s"
  Otherwise, then "<sec>s"

Practical:

These functions are useful for showing how much time has elapsed since a particular event. For instance, they can convert your idle time from the number of seconds to a more readable form.

Returns:

A human readable string representing some elapsed time.

Examples:

$tdiff(248576)      returns "2 days 21 hours 2 minutes 56 seconds"
$tdiff(-248576)     returns "-2 days -21 hours -2 minutes -56 seconds"
$tdiff2(248576)     returns "2d 21h 2m 56s"
$tdiff2(-248576)    returns "-2d -21h -2m -56s"
$tdiff2(3602)       returns "1h 2s"  Notice the absence of minutes.

History:

This function first appeared in ircII+CS