$duration - Revision history

Zyberdog: changed to wiki-pipe-tables + tweaked

2005-11-26T18:11:15Z

changed to wiki-pipe-tables + tweaked

← Older revision		Revision as of 18:11, 26 November 2005
Line 6:		Line 6:
	$duration(interval, N)		$duration(interval, N)

	$duration~~(3660) returns "1hr 1min".~~		* ''N'' is an optional parameter which specifies how $duration formats the time:

	N ~~is an optional parameter which specifies how $duration formats~~ the ~~time~~:		{\| style="width:100%;"
			\|-
			\| style="width:5%;" \|'''''N'''''
			\| style="width:90%;" \|'''''Meaning'''''
			\|-
			\| 2
			\| do not include seconds in the result
			\|-
			\| 3
			\| return in the H:m:s format
			\|}

	~~<table width~~=~~"100%">~~		== Example ==
	~~<tr><td width~~=~~"5%"><b>N</b></td><td width~~=~~"90%"><b>Meaning</b></td></tr>~~
	~~<tr><td>2</td><td>do not include seconds in the result</td></tr>~~
	~~<tr><td>3</td><td>$duration uses the H:m:s format</td></tr>~~
	~~</table>~~

	~~== Examples ==~~		$duration(3665) ;returns ''1hr 1min 5secs''
			$duration(3665,2) ;returns ''1hr 1min''
			$duration(3665,3) ;returns ''01:01:05''

	=== Time since a specific date ===		=== Time since a specific date ===
Line 27:		Line 35:

	[[var]] %when = 1wk 3days 19hrs 41mins 15secs		[[var]] %when = 1wk 3days 19hrs 41mins 15secs
	var %ts = $duration(%when) ;;This will give us the amount of seconds ''(934875)'' that is in ''%when''		var %ts = $duration(%when) ;This will give us the amount of seconds ''(934875)'' that is in ''%when''
	var %ts = [[$calc]]([[$ctime]] + %ts) ;;Add ''$ctime'' (the current time in seconds) to the varible.		var %ts = [[$calc]]([[$ctime]] + %ts) ;Add ''$ctime'' (the current time in seconds) to the varible.
	echo -a The date and time in %when will be [[$asctime]](%ts)		echo -a The date and time in %when will be [[$asctime]](%ts)
	[[Category:Time and Date Identifiers]]		[[Category:Time and Date Identifiers]]

Doomie: changed the table a bit as it did look weird (imo)

2005-11-26T17:53:52Z

changed the table a bit as it did look weird (imo)

← Older revision		Revision as of 17:53, 26 November 2005
Line 10:		Line 10:
	N is an optional parameter which specifies how $duration formats the time:		N is an optional parameter which specifies how $duration formats the time:

	<table ~~border~~="1">		<table width="100%">
	<tr><td>N</td><td>Meaning</td></tr>		<tr><td width="5%"><b>N</b></td><td width="90%"><b>Meaning</b></td></tr>
	<tr><td>2</td><td>do not include seconds in the result</td></tr>		<tr><td>2</td><td>do not include seconds in the result</td></tr>
	<tr><td>3</td><td>$duration uses the H:m:s format</td></tr>		<tr><td>3</td><td>$duration uses the H:m:s format</td></tr>

Doomie: 1986, not 1086 ;)

2005-11-26T17:48:51Z

1986, not 1086 ;)

← Older revision		Revision as of 17:48, 26 November 2005
Line 22:		Line 22:
	[[echo]] -a $duration([[$calc]]([[$ctime]] - $ctime(10.02.1986 00:00)))		[[echo]] -a $duration([[$calc]]([[$ctime]] - $ctime(10.02.1986 00:00)))

	This command echos how much time has passed since the 10th February ~~1086~~.		This command echos how much time has passed since the 10th February 1986.

	=== Reverting human readable text into an integer we can use to calculate ===		=== Reverting human readable text into an integer we can use to calculate ===

Albie: Added human readable to seconds convertion

2005-11-26T16:42:46Z

Added human readable to seconds convertion

New page

Converts an interval (unit: seconds) in to a human-readable format.
It is also capable of converting the human readable format in to [[$ctime|total number of seconds elapsed since 00:00:00 GMT, January 1, 1970]].

'''Note:''' When converting from human readable to numerical $duration will treat 1wk, 1w, 1week and 1 week as the same value. It is also worth noting that months and years do not have a set valid so can not be converted.

$duration(interval, N)

$duration(3660) returns "1hr 1min".

N is an optional parameter which specifies how $duration formats the time:

<table border="1">
<tr><td>N</td><td>Meaning</td></tr>
<tr><td>2</td><td>do not include seconds in the result</td></tr>
<tr><td>3</td><td>$duration uses the H:m:s format</td></tr>
</table>

== Examples ==

=== Time since a specific date ===

[[echo]] -a $duration([[$calc]]([[$ctime]] - $ctime(10.02.1986 00:00)))

This command echos how much time has passed since the 10th February 1086.

=== Reverting human readable text into an integer we can use to calculate ===

[[var]] %when = 1wk 3days 19hrs 41mins 15secs
var %ts = $duration(%when) ;;This will give us the amount of seconds ''(934875)'' that is in ''%when''
var %ts = [[$calc]]([[$ctime]] + %ts) ;;Add ''$ctime'' (the current time in seconds) to the varible.
echo -a The date and time in %when will be [[$asctime]](%ts)
[[Category:Time and Date Identifiers]]