Difference between revisions of "$duration"
From Scriptwiki
(Added human readable to seconds convertion) |
m (changed to wiki-pipe-tables + tweaked) |
||
| (2 intermediate revisions by one other user not shown) | |||
| Line 6: | Line 6: | ||
$duration(interval, N) | $duration(interval, N) | ||
| − | $duration | + | * ''N'' is an optional parameter which specifies how $duration formats the time: |
| − | N | + | {| 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 | ||
| + | |} | ||
| − | + | == Example == | |
| − | |||
| − | |||
| − | |||
| − | |||
| − | + | $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 22: | Line 30: | ||
[[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 | + | 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 === | ||
[[var]] %when = 1wk 3days 19hrs 41mins 15secs | [[var]] %when = 1wk 3days 19hrs 41mins 15secs | ||
| − | var %ts = $duration(%when) | + | var %ts = $duration(%when) ;This will give us the amount of seconds ''(934875)'' that is in ''%when'' |
| − | var %ts = [[$calc]]([[$ctime]] + %ts) | + | 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]] | ||
Latest revision as of 19:11, 26 November 2005
Converts an interval (unit: seconds) in to a human-readable format. It is also capable of converting the human readable format in to 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)
- N is an optional parameter which specifies how $duration formats the time:
| N | Meaning |
| 2 | do not include seconds in the result |
| 3 | return in the H:m:s format |
Example
$duration(3665) ;returns 1hr 1min 5secs $duration(3665,2) ;returns 1hr 1min $duration(3665,3) ;returns 01:01:05
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 1986.
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)
