SecondsToHours (CMS) - Revision history

AFRLme at 13:49, 22 February 2015

2015-02-22T13:49:48Z

AFRLme at 13:34, 22 February 2015

2015-02-22T13:34:20Z

AFRLme at 13:33, 22 February 2015

2015-02-22T13:33:25Z

AFRLme at 13:32, 22 February 2015

2015-02-22T13:32:38Z

AFRLme: Created page with "{| class="ts" style="width:100%" |- ! style="text-align:left" | Name !! style="text-align:left" | Type !! style="text-align:left" | By |- | secondsToHours(v, b) || Definition..."

2015-02-22T13:31:09Z

Created page with "{| class="ts" style="width:100%" |- ! style="text-align:left" | Name !! style="text-align:left" | Type !! style="text-align:left" | By |- | secondsToHours(v, b) || Definition..."

New page

{| class="ts" style="width:100%"
|-
! style="text-align:left" | Name !! style="text-align:left" | Type !! style="text-align:left" | By
|-
| secondsToHours(v, b) || Definition || AFRLme
|}

This small function allows you to quickly convert seconds into the hh time format.
{| class="ts"
|-
| ''d = day, h = hour, m = minute, s = seconds.''
|-
| ''There are 86400 seconds in a day, 3600 seconds in an hour & 60 seconds in a minute.''
|}

== Instructions ==
1. Add the [[#Main_Script|main script]] to the Visionaire Studio Script Editor & set the script as a definition script. 
2a. To use this function (with day calculation enabled), create an ''execute a script'' containing...
<syntaxhighlight>
secondsToTime(86400, true) -- will return (00) 0 hours -- because we have declared that it should take days into consideration too.
</syntaxhighlight>
2b. To use this function (with day calculation disabled), create an ''execute a script'' containing...
<syntaxhighlight>
secondsToTime(86400, false) -- will return (24) 24 hours -- because we have declared that it should not take days into consideration.
</syntaxhighlight>
2c. Here is an example of how you could use this function...
<syntaxhighlight>
Values["play_time"].String = secondsToTime(Values["play_time"].ValueInt, false) -- here we are converting the integer value stored in the integer field of the value into a string time format which can be returned in a displayed text action part using the <vs=value_name> field.
</syntaxhighlight>

== Main Script ==
<syntaxhighlight>
function secondsToTime(v, b)
if b then v = math.floor(v % 86400 / 3600) else v = math.floor(v / 3600) end
-- + --
if v < 10 then v = tostring("0" .. v) end
-- + --
return tostring( v )
end
</syntaxhighlight>

== Syntax Breakdown ==
{| class="ts" style="width:100%"
|-
! style="text-align:left" | Name !! style="text-align:left" | Type !! style="text-align:left;width:80%" | Description
|-
| v || integer || This should be an integer (number) value of the amount of seconds you want to split into the hh time format.
|-
| b || boolean || This should be a boolean value of true ''or'' false.
|}{{toc}}

@@ Line 27: / Line 27: @@
 c. Here is an example of how you could use this function...
 <syntaxhighlight>
-Values["play_time"].String = secondsToHours(Values["play_time"].ValueInt, false) -- here we are converting the integer value stored in the integer field of the value into a string time format which can be returned in a displayed text action part using the <vs=value_name> field.
+Values["hours"].String = secondsToHours(Values["play_time"].ValueInt, false) -- here we are converting the integer value stored in the integer field of the value into a string time format which can be returned in a displayed text action part using the <vs=value_name> field.
 </syntaxhighlight>

@@ Line 19: / Line 19: @@
 a. To use this function (with day calculation enabled), create an ''execute a script'' containing...
 <syntaxhighlight>
-secondsToHours(86400, true) -- will return (00) 0 hours -- because we have declared that it should take days into consideration too.
+secondsToHours(86400, true) -- will return (00) 0 hours, because we have declared that it should take days into consideration too.
 </syntaxhighlight>
 b. To use this function (with day calculation disabled), create an ''execute a script'' containing...
 <syntaxhighlight>
-secondsToHours(86400, false) -- will return (24) 24 hours -- because we have declared that it should not take days into consideration.
+secondsToHours(86400, false) -- will return (24) 24 hours, because we have declared that it should not take days into consideration.
 </syntaxhighlight>
 c. Here is an example of how you could use this function...

@@ Line 32: / Line 32: @@
 == Main Script ==
 <syntaxhighlight>
-function secondsToTime(v, b)
+function secondsToHours(v, b)
   if b then v = math.floor(v % 86400 / 3600) else v = math.floor(v / 3600) end
   -- + --