<html>
<head>
<title>TCCDateTime_Functions - TCCUsefulFunctions</title>
<link rel="stylesheet" type="text/css" href="../styles/main.css">
<script language=JavaScript src="../javascript/main.js"></script></head>
<body class="FramedContentPage" onLoad="NDOnLoad()">
<script language=JavaScript>
<!--
if (browserType) {document.write("<div class=" + browserType + ">");if (browserVer) {document.write("<div class=" + browserVer + ">"); }}// --></script>
<!-- Generated by Natural Docs, version 1.4 -->
<!-- http://www.naturaldocs.org -->
<!-- saved from url=(0026)http://www.naturaldocs.org -->
<div id=Content>
<div class="CFile">
<div class=CTopic id=MainTopic>
<h1 class=CTitle>
<a name="TCCDateTime_Functions"></a>TCCDateTime_Functions</h1>
<div class=CBody>
<h4 class=CHeading>Purpose</h4>
<p>This module supports date and time handling</p>
<h4 class=CHeading>Module Parameters</h4>
<p>-</p>
<h4 class=CHeading>Module depends on</h4>
<p>-</p>
<!--START_ND_SUMMARY-->
<div class=Summary>
<div class=STitle>Summary</div>
<div class=SBorder>
<table border=0 cellspacing=0 cellpadding=0 class=STable>
<tr class="SMain">
<td class=SEntry>
<a href="#TCCDateTime_Functions" >TCCDateTime_Functions</a></td>
<td class=SDescription>This module supports date and time handling</td></tr>
<tr class="SGroup">
<td class=SEntry>
<a href="#Functions" >Functions</a></td>
<td class=SDescription></td></tr>
<tr class="SFunction SIndent1 SMarked">
<td class=SEntry>
<a href="#f_time" id=link1 onMouseOver="ShowTip(event, 'tt1', 'link1')" onMouseOut="HideTip('tt1')">f_time</a></td>
<td class=SDescription>Current calendar time of the system in seconds</td></tr>
<tr class="SFunction SIndent1">
<td class=SEntry>
<a href="#f_ctime" id=link2 onMouseOver="ShowTip(event, 'tt2', 'link2')" onMouseOut="HideTip('tt2')">f_ctime</a></td>
<td class=SDescription>Convert a time value in seconds to human readable string The time represented as local time</td></tr>
<tr class="SFunction SIndent1 SMarked">
<td class=SEntry>
<a href="#f_ctime_UTC" id=link3 onMouseOver="ShowTip(event, 'tt3', 'link3')" onMouseOut="HideTip('tt3')">f_ctime_UTC</a></td>
<td class=SDescription>Convert a time value in seconds to human readable string The time represented as UTC</td></tr>
<tr class="SFunction SIndent1">
<td class=SEntry>
<a href="#f_getTimeFormatted" id=link4 onMouseOver="ShowTip(event, 'tt4', 'link4')" onMouseOut="HideTip('tt4')">f_getTimeFormatted</a></td>
<td class=SDescription>Return the current calendar time in a formatted way</td></tr>
<tr class="SFunction SIndent1 SMarked">
<td class=SEntry>
<a href="#f_time2sec" id=link5 onMouseOver="ShowTip(event, 'tt5', 'link5')" onMouseOut="HideTip('tt5')">f_time2sec</a></td>
<td class=SDescription>function to convert a formated time value to seconds The time represented as local time</td></tr>
<tr class="SFunction SIndent1">
<td class=SEntry>
<a href="#f_time2sec_UTC" id=link6 onMouseOver="ShowTip(event, 'tt6', 'link6')" onMouseOut="HideTip('tt6')">f_time2sec_UTC</a></td>
<td class=SDescription>function to convert a formated time value to seconds The time represented as UTC</td></tr>
<tr class="SFunction SIndent1 SMarked">
<td class=SEntry>
<a href="#f_getCurrentDateWithOffset" id=link7 onMouseOver="ShowTip(event, 'tt7', 'link7')" onMouseOut="HideTip('tt7')">f_getCurrentDateWithOffset</a></td>
<td class=SDescription>Generate a date from the actual date and time plus the parameter in seconds e.g. </td></tr>
<tr class="SFunction SIndent1">
<td class=SEntry>
<a href="#f_getCurrentGMTDate" id=link8 onMouseOver="ShowTip(event, 'tt8', 'link8')" onMouseOut="HideTip('tt8')">f_getCurrentGMTDate</a></td>
<td class=SDescription>Return the current GMT date in format RFC 1123-Date ex :Sat, 13 Nov 2010 23:30:02 GMT</td></tr>
<tr class="SFunction SIndent1 SMarked">
<td class=SEntry>
<a href="#f_tic" id=link9 onMouseOver="ShowTip(event, 'tt9', 'link9')" onMouseOut="HideTip('tt9')">f_tic</a></td>
<td class=SDescription>Return the number of clock ticks used by the application since the program was launched</td></tr>
<tr class="SFunction SIndent1">
<td class=SEntry>
<a href="#f_toc" id=link10 onMouseOver="ShowTip(event, 'tt10', 'link10')" onMouseOut="HideTip('tt10')">f_toc</a></td>
<td class=SDescription>Elapsed seconds since time t (only when f_tic() returns the number of clock ticks elapsed since the program was launched)</td></tr>
<tr class="SFunction SIndent1 SMarked">
<td class=SEntry>
<a href="#f_timeDiff" id=link11 onMouseOver="ShowTip(event, 'tt11', 'link11')" onMouseOut="HideTip('tt11')">f_timeDiff</a></td>
<td class=SDescription>Difference between two time</td></tr></table></div></div>
<!--END_ND_SUMMARY--></div></div></div>
<div class="CGroup">
<div class=CTopic>
<h3 class=CTitle>
<a name="Functions"></a>Functions</h3></div></div>
<div class="CFunction">
<div class=CTopic>
<h3 class=CTitle>
<a name="f_time"></a>f_time</h3>
<div class=CBody>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>external function f_time() return integer</td></tr></table></blockquote>
<h4 class=CHeading>Purpose</h4>
<p>Current calendar time of the system in seconds</p>
<h4 class=CHeading>Parameters</h4>
<p>-</p>
<h4 class=CHeading>Return Value</h4>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>integer</td>
<td class=CDLDescription>time value</td></tr></table>
<h4 class=CHeading>Errors</h4>
<p>-</p>
<h4 class=CHeading>Detailed description</h4>
<p>-</p></div></div></div>
<div class="CFunction">
<div class=CTopic>
<h3 class=CTitle>
<a name="f_ctime"></a>f_ctime</h3>
<div class=CBody>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>
<table border=0 cellspacing=0 cellpadding=0>
<tr>
<td class=PBeforeParameters nowrap>external function f_ctime(</td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_sec</td>
<td class=PAfterParameters nowrap>) return charstring</td></tr></table></td></tr></table></blockquote>
<h4 class=CHeading>Purpose</h4>
<p>Convert a time value in seconds to human readable string The time represented as local time</p>
<h4 class=CHeading>Parameters</h4>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>pl_sec</td>
<td class=CDLDescription>
<b>in</b>
<b>integer</b> - time value</td></tr></table>
<h4 class=CHeading>Return Value</h4>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>integer</td>
<td class=CDLDescription>converted time value</td></tr></table>
<h4 class=CHeading>Errors</h4>
<p>-</p>
<h4 class=CHeading>Detailed description</h4>
<p>-</p></div></div></div>
<div class="CFunction">
<div class=CTopic>
<h3 class=CTitle>
<a name="f_ctime_UTC"></a>f_ctime_UTC</h3>
<div class=CBody>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>
<table border=0 cellspacing=0 cellpadding=0>
<tr>
<td class=PBeforeParameters nowrap>external function f_ctime_UTC(</td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_sec</td>
<td class=PAfterParameters nowrap>) return charstring</td></tr></table></td></tr></table></blockquote>
<h4 class=CHeading>Purpose</h4>
<p>Convert a time value in seconds to human readable string The time represented as UTC</p>
<h4 class=CHeading>Parameters</h4>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>pl_sec</td>
<td class=CDLDescription>
<b>in</b>
<b>integer</b> - time value</td></tr></table>
<h4 class=CHeading>Return Value</h4>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>integer</td>
<td class=CDLDescription>converted time value</td></tr></table>
<h4 class=CHeading>Errors</h4>
<p>-</p>
<h4 class=CHeading>Detailed description</h4>
<p>-</p></div></div></div>
<div class="CFunction">
<div class=CTopic>
<h3 class=CTitle>
<a name="f_getTimeFormatted"></a>f_getTimeFormatted</h3>
<div class=CBody>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>
<table border=0 cellspacing=0 cellpadding=0>
<tr>
<td class=PBeforeParameters nowrap>external function f_getTimeFormatted(</td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_sec,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>charstring </td>
<td class=PParameter nowrap>pl_format</td>
<td class=PAfterParameters nowrap>) return charstring</td></tr></table></td></tr></table></blockquote>
<h4 class=CHeading>Purpose</h4>
<p>Return the current calendar time in a formatted way</p>
<h4 class=CHeading>Parameters</h4>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>pl_sec</td>
<td class=CDLDescription>
<b>in</b>
<b>integer</b> - time value in seconds</td></tr>
<tr>
<td class=CDLEntry>pl_format</td>
<td class=CDLDescription>
<b>in</b>
<b>charstring</b> - format string</td></tr></table>
<h4 class=CHeading>Return Value</h4>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>charstring</td>
<td class=CDLDescription>formatted time in string format</td></tr></table>
<h4 class=CHeading>Errors</h4>
<p>-</p>
<h4 class=CHeading>Detailed description</h4>
<p>
<b>Specifier / Replaced by / Example</b></p>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>%a</td>
<td class=CDLDescription>Abbreviated weekday name * - Thu</td></tr>
<tr>
<td class=CDLEntry>%A</td>
<td class=CDLDescription>Full weekday name * - Thursday</td></tr>
<tr>
<td class=CDLEntry>%b</td>
<td class=CDLDescription>Abbreviated month name * - Aug</td></tr>
<tr>
<td class=CDLEntry>%B</td>
<td class=CDLDescription>Full month name * - August</td></tr>
<tr>
<td class=CDLEntry>%c</td>
<td class=CDLDescription>Date and time representation * - Thu Aug 23 14:55:02 2001</td></tr>
<tr>
<td class=CDLEntry>%d</td>
<td class=CDLDescription>Day of the month (01-31) - 23</td></tr>
<tr>
<td class=CDLEntry>%H</td>
<td class=CDLDescription>Hour in 24h format (00-23) - 14</td></tr>
<tr>
<td class=CDLEntry>%I</td>
<td class=CDLDescription>Hour in 12h format (01-12) - 02</td></tr>
<tr>
<td class=CDLEntry>%j</td>
<td class=CDLDescription>Day of the year (001-366) - 235</td></tr>
<tr>
<td class=CDLEntry>%m</td>
<td class=CDLDescription>Month as a decimal number (01-12) - 08</td></tr>
<tr>
<td class=CDLEntry>%M</td>
<td class=CDLDescription>Minute (00-59) - 55</td></tr>
<tr>
<td class=CDLEntry>%p</td>
<td class=CDLDescription>AM or PM designation - PM</td></tr>
<tr>
<td class=CDLEntry>%S</td>
<td class=CDLDescription>Second (00-61) - 02</td></tr>
<tr>
<td class=CDLEntry>%U</td>
<td class=CDLDescription>Week number with the first Sunday as the first day of week one (00-53) - 33</td></tr>
<tr>
<td class=CDLEntry>%w</td>
<td class=CDLDescription>Weekday as a decimal number with Sunday as 0 (0-6) - 4</td></tr>
<tr>
<td class=CDLEntry>%W</td>
<td class=CDLDescription>Week number with the first Monday as the first day of week one (00-53) - 34</td></tr>
<tr>
<td class=CDLEntry>%x</td>
<td class=CDLDescription>Date representation * - 08/23/01</td></tr>
<tr>
<td class=CDLEntry>%X</td>
<td class=CDLDescription>Time representation * - 14:55:02</td></tr>
<tr>
<td class=CDLEntry>%y</td>
<td class=CDLDescription>Year, last two digits (00-99) - 01</td></tr>
<tr>
<td class=CDLEntry>%Y</td>
<td class=CDLDescription>Year - 2001</td></tr>
<tr>
<td class=CDLEntry>%Z</td>
<td class=CDLDescription>Timezone name or abbreviation - CDT</td></tr>
<tr>
<td class=CDLEntry>%%</td>
<td class=CDLDescription>A % sign - %</td></tr></table>
<ul>
<li>The specifiers whose description is marked with an asterisk (*) are locale-dependent.</li></ul></div></div></div>
<div class="CFunction">
<div class=CTopic>
<h3 class=CTitle>
<a name="f_time2sec"></a>f_time2sec</h3>
<div class=CBody>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>
<table border=0 cellspacing=0 cellpadding=0>
<tr>
<td class=PBeforeParameters nowrap>external function f_time2sec(</td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_year,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_mon,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_day,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_hour,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_min,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_sec</td>
<td class=PAfterParameters nowrap>) return integer</td></tr></table></td></tr></table></blockquote>
<h4 class=CHeading>Purpose</h4>
<p>function to convert a formated time value to seconds The time represented as local time</p>
<h4 class=CHeading>Parameters</h4>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>pl_year</td>
<td class=CDLDescription>
<b>in</b>
<b>integer</b> - year (e.g. 2007)</td></tr>
<tr>
<td class=CDLEntry>pl_mon</td>
<td class=CDLDescription>
<b>in</b>
<b>integer</b> - month (e.g. 3)</td></tr>
<tr>
<td class=CDLEntry>pl_day</td>
<td class=CDLDescription>
<b>in</b>
<b>integer</b> - day (e.g. 7)</td></tr>
<tr>
<td class=CDLEntry>pl_hour</td>
<td class=CDLDescription>
<b>in</b>
<b>integer</b> - day (e.g. 12)</td></tr>
<tr>
<td class=CDLEntry>pl_min</td>
<td class=CDLDescription>
<b>in</b>
<b>integer</b> - day (e.g. 50)</td></tr>
<tr>
<td class=CDLEntry>pl_sec</td>
<td class=CDLDescription>
<b>in</b>
<b>integer</b> - day (e.g. 7)</td></tr></table>
<h4 class=CHeading>Return Value</h4>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>integer</td>
<td class=CDLDescription>time in seconds</td></tr></table>
<h4 class=CHeading>Errors</h4>
<p>-</p>
<h4 class=CHeading>Detailed description</h4>
<p>time in seconds since January 1, 1900</p></div></div></div>
<div class="CFunction">
<div class=CTopic>
<h3 class=CTitle>
<a name="f_time2sec_UTC"></a>f_time2sec_UTC</h3>
<div class=CBody>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>
<table border=0 cellspacing=0 cellpadding=0>
<tr>
<td class=PBeforeParameters nowrap>external function f_time2sec_UTC(</td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_year,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_mon,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_day,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_hour,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_min,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_sec</td>
<td class=PAfterParameters nowrap>) return integer</td></tr></table></td></tr></table></blockquote>
<h4 class=CHeading>Purpose</h4>
<p>function to convert a formated time value to seconds The time represented as UTC</p>
<h4 class=CHeading>Parameters</h4>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>pl_year</td>
<td class=CDLDescription>
<b>in</b>
<b>integer</b> - year (e.g. 2007)</td></tr>
<tr>
<td class=CDLEntry>pl_mon</td>
<td class=CDLDescription>
<b>in</b>
<b>integer</b> - month (e.g. 3)</td></tr>
<tr>
<td class=CDLEntry>pl_day</td>
<td class=CDLDescription>
<b>in</b>
<b>integer</b> - day (e.g. 7)</td></tr>
<tr>
<td class=CDLEntry>pl_hour</td>
<td class=CDLDescription>
<b>in</b>
<b>integer</b> - day (e.g. 12)</td></tr>
<tr>
<td class=CDLEntry>pl_min</td>
<td class=CDLDescription>
<b>in</b>
<b>integer</b> - day (e.g. 50)</td></tr>
<tr>
<td class=CDLEntry>pl_sec</td>
<td class=CDLDescription>
<b>in</b>
<b>integer</b> - day (e.g. 7)</td></tr></table>
<h4 class=CHeading>Return Value</h4>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>integer</td>
<td class=CDLDescription>time in seconds</td></tr></table>
<h4 class=CHeading>Errors</h4>
<p>-</p>
<h4 class=CHeading>Detailed description</h4>
<p>time in seconds since January 1, 1900</p></div></div></div>
<div class="CFunction">
<div class=CTopic>
<h3 class=CTitle>
<a name="f_getCurrentDateWithOffset"></a>f_getCurrentDateWithOffset</h3>
<div class=CBody>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>
<table border=0 cellspacing=0 cellpadding=0>
<tr>
<td class=PBeforeParameters nowrap>external function f_getCurrentDateWithOffset(</td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_sec</td>
<td class=PAfterParameters nowrap>) return charstring</td></tr></table></td></tr></table></blockquote>
<h4 class=CHeading>Purpose</h4>
<p>Generate a date from the actual date and time plus the parameter in seconds e.g. getSdate(30) will return a charstring containing the date and time of 30 seconds later</p>
<h4 class=CHeading>Parameters</h4>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>pl_sec</td>
<td class=CDLDescription>
<b>in</b>
<b>integer</b> - offset time value</td></tr></table>
<h4 class=CHeading>Return Value</h4>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>charstring</td>
<td class=CDLDescription>formatted time in string format</td></tr></table>
<h4 class=CHeading>Errors</h4>
<p>-</p>
<h4 class=CHeading>Detailed description</h4>
<p>-</p></div></div></div>
<div class="CFunction">
<div class=CTopic>
<h3 class=CTitle>
<a name="f_getCurrentGMTDate"></a>f_getCurrentGMTDate</h3>
<div class=CBody>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>external function f_getCurrentGMTDate() return charstring</td></tr></table></blockquote>
<h4 class=CHeading>Purpose</h4>
<p>Return the current GMT date in format RFC 1123-Date ex :Sat, 13 Nov 2010 23:30:02 GMT</p>
<h4 class=CHeading>Parameters</h4>
<p>-</p>
<h4 class=CHeading>Return Value</h4>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>charstring</td>
<td class=CDLDescription>formatted time in string format</td></tr></table>
<h4 class=CHeading>Errors</h4>
<p>-</p>
<h4 class=CHeading>Detailed description</h4>
<p>-</p></div></div></div>
<div class="CFunction">
<div class=CTopic>
<h3 class=CTitle>
<a name="f_tic"></a>f_tic</h3>
<div class=CBody>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>external function f_tic() return integer</td></tr></table></blockquote>
<h4 class=CHeading>Purpose</h4>
<p>Return the number of clock ticks used by the application since the program was launched</p>
<p>OR</p>
<p>Return the amount of CPU time in microseconds since the last call of f_tic</p>
<p>OR ...</p>
<p>Warning! This function depends on used library version. Be careful!</p>
<h4 class=CHeading>Parameters</h4>
<p>-</p>
<h4 class=CHeading>Return Value</h4>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>integer</td>
<td class=CDLDescription>tics since program start</td></tr></table>
<h4 class=CHeading>Errors</h4>
<p>-</p>
<h4 class=CHeading>Detailed description</h4>
<p>-</p></div></div></div>
<div class="CFunction">
<div class=CTopic>
<h3 class=CTitle>
<a name="f_toc"></a>f_toc</h3>
<div class=CBody>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>
<table border=0 cellspacing=0 cellpadding=0>
<tr>
<td class=PBeforeParameters nowrap>external function f_toc(</td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>t</td>
<td class=PAfterParameters nowrap>) return float</td></tr></table></td></tr></table></blockquote>
<h4 class=CHeading>Purpose</h4>
<p>Elapsed seconds since time t (only when f_tic() returns the number of clock ticks elapsed since the program was launched)</p>
<p>Warning! This function depends on used library version. Be careful!</p>
<h4 class=CHeading>Parameters</h4>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>t</td>
<td class=CDLDescription>
<b>in</b>
<b>integer</b> - time value</td></tr></table>
<h4 class=CHeading>Return Value</h4>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>float</td>
<td class=CDLDescription>elapsed seconds</td></tr></table>
<h4 class=CHeading>Errors</h4>
<p>-</p>
<h4 class=CHeading>Detailed description</h4>
<p>f_tic counts clock tics since program start. f_toc counts seconds since clock() readout in t till current time</p></div></div></div>
<div class="CFunction">
<div class=CTopic>
<h3 class=CTitle>
<a name="f_timeDiff"></a>f_timeDiff</h3>
<div class=CBody>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>
<table border=0 cellspacing=0 cellpadding=0>
<tr>
<td class=PBeforeParameters nowrap>external function f_timeDiff(</td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>t_stop,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>t_start</td>
<td class=PAfterParameters nowrap>) return integer</td></tr></table></td></tr></table></blockquote>
<h4 class=CHeading>Purpose</h4>
<p>Difference between two time</p>
<h4 class=CHeading>Parameters</h4>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>t_start</td>
<td class=CDLDescription>
<b>in</b>
<b>integer</b> - start time</td></tr>
<tr>
<td class=CDLEntry>t_stop</td>
<td class=CDLDescription>
<b>in</b>
<b>integer</b> - stop time</td></tr></table>
<h4 class=CHeading>Return Value</h4>
<table border=0 cellspacing=0 cellpadding=0 class=CDescriptionList>
<tr>
<td class=CDLEntry>integer</td>
<td class=CDLDescription>t_stop-t_start</td></tr></table>
<h4 class=CHeading>Errors</h4>
<p>-</p>
<h4 class=CHeading>Detailed description</h4>
<p>-</p></div></div></div>
</div>
<!--Content-->
<!--START_ND_TOOLTIPS-->
<div class=CToolTip id="tt1">
<div class=CFunction>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>external function f_time() return integer</td></tr></table></blockquote>Current calendar time of the system in seconds</div></div>
<div class=CToolTip id="tt2">
<div class=CFunction>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>
<table border=0 cellspacing=0 cellpadding=0>
<tr>
<td class=PBeforeParameters nowrap>external function f_ctime(</td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_sec</td>
<td class=PAfterParameters nowrap>) return charstring</td></tr></table></td></tr></table></blockquote>Convert a time value in seconds to human readable string The time represented as local time</div></div>
<div class=CToolTip id="tt3">
<div class=CFunction>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>
<table border=0 cellspacing=0 cellpadding=0>
<tr>
<td class=PBeforeParameters nowrap>external function f_ctime_UTC(</td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_sec</td>
<td class=PAfterParameters nowrap>) return charstring</td></tr></table></td></tr></table></blockquote>Convert a time value in seconds to human readable string The time represented as UTC</div></div>
<div class=CToolTip id="tt4">
<div class=CFunction>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>
<table border=0 cellspacing=0 cellpadding=0>
<tr>
<td class=PBeforeParameters nowrap>external function f_getTimeFormatted(</td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_sec,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>charstring </td>
<td class=PParameter nowrap>pl_format</td>
<td class=PAfterParameters nowrap>) return charstring</td></tr></table></td></tr></table></blockquote>Return the current calendar time in a formatted way</div></div>
<div class=CToolTip id="tt5">
<div class=CFunction>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>
<table border=0 cellspacing=0 cellpadding=0>
<tr>
<td class=PBeforeParameters nowrap>external function f_time2sec(</td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_year,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_mon,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_day,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_hour,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_min,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_sec</td>
<td class=PAfterParameters nowrap>) return integer</td></tr></table></td></tr></table></blockquote>function to convert a formated time value to seconds The time represented as local time</div></div>
<div class=CToolTip id="tt6">
<div class=CFunction>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>
<table border=0 cellspacing=0 cellpadding=0>
<tr>
<td class=PBeforeParameters nowrap>external function f_time2sec_UTC(</td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_year,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_mon,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_day,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_hour,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_min,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_sec</td>
<td class=PAfterParameters nowrap>) return integer</td></tr></table></td></tr></table></blockquote>function to convert a formated time value to seconds The time represented as UTC</div></div>
<div class=CToolTip id="tt7">
<div class=CFunction>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>
<table border=0 cellspacing=0 cellpadding=0>
<tr>
<td class=PBeforeParameters nowrap>external function f_getCurrentDateWithOffset(</td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>pl_sec</td>
<td class=PAfterParameters nowrap>) return charstring</td></tr></table></td></tr></table></blockquote>Generate a date from the actual date and time plus the parameter in seconds e.g. </div></div>
<div class=CToolTip id="tt8">
<div class=CFunction>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>external function f_getCurrentGMTDate() return charstring</td></tr></table></blockquote>Return the current GMT date in format RFC 1123-Date ex :Sat, 13 Nov 2010 23:30:02 GMT</div></div>
<div class=CToolTip id="tt9">
<div class=CFunction>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>external function f_tic() return integer</td></tr></table></blockquote>Return the number of clock ticks used by the application since the program was launched</div></div>
<div class=CToolTip id="tt10">
<div class=CFunction>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>
<table border=0 cellspacing=0 cellpadding=0>
<tr>
<td class=PBeforeParameters nowrap>external function f_toc(</td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>t</td>
<td class=PAfterParameters nowrap>) return float</td></tr></table></td></tr></table></blockquote>Elapsed seconds since time t (only when f_tic() returns the number of clock ticks elapsed since the program was launched)</div></div>
<div class=CToolTip id="tt11">
<div class=CFunction>
<blockquote>
<table border=0 cellspacing=0 cellpadding=0 class=Prototype>
<tr>
<td>
<table border=0 cellspacing=0 cellpadding=0>
<tr>
<td class=PBeforeParameters nowrap>external function f_timeDiff(</td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>t_stop,</td></tr>
<tr>
<td></td>
<td class=PType nowrap>integer </td>
<td class=PParameter nowrap>t_start</td>
<td class=PAfterParameters nowrap>) return integer</td></tr></table></td></tr></table></blockquote>Difference between two time</div></div>
<!--END_ND_TOOLTIPS-->
<script language=JavaScript>
<!--
if (browserType) {if (browserVer) {document.write("</div>"); }document.write("</div>");}// --></script></body></html>