home *** CD-ROM | disk | FTP | other *** search
/ Kompuutteri Kaikille K-CD 2002 #3 / K-CD_2002-03.iso / OpenOffice / f_0046 / sbasic.jar / text / sbasic / common / 03030206.xml < prev    next >
Extensible Markup Language  |  2001-09-07  |  3KB  |  42 lines
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <html><head><title>TimeValue Function [Runtime]</title><meta name="filename" content="text/sbasic/common/03030206"/><help:css-file-link xmlns:help="http://openoffice.org/2000/help"/><!--The CSS style header method for setting styles--><style type="text/css">
  3.  
  4.         p.P1{
  5.                 }
  6.         span.T1{
  7.                 font-weight:bold;}
  8.         </style></head><body>
  9.   
  10.   
  11.   <help:to-be-embedded Eid="timevalue" xmlns:help="http://openoffice.org/2000/help"><a name="timevalue"/>
  12.   <p class="Head1"><help:link Id="66550">TimeValue Function [Runtime]</help:link></p>
  13.   <p class="Paragraph">Calculates a serial time value from the specified hour, minute, and second - parameters passed as strings - that represents the time in a single numeric value. This value can be used to calculate the difference between times.</p>
  14.   </help:to-be-embedded>
  15.   <p class="Paragraph"><span class="T1">Syntax</span>:</p>
  16.   <p class="Paragraph">TimeValue (Text As String) <help:key-word value="TimeValue" tag="kw66550_1" xmlns:help="http://openoffice.org/2000/help"/></p>
  17.   <p class="Paragraph"><span class="T1">Return value</span>:</p>
  18.   <p class="Paragraph">Date</p>
  19.   <p class="Paragraph"><span class="T1">Parameter</span>:</p>
  20.   <p class="Paragraph">Text: Any string expression that contains the time to be calculated in the format "HH:MM:SS".</p>
  21.   <p class="Paragraph">With this function, you can convert any time into a single value, with which you can calculate time differences.</p>
  22.   <p class="Paragraph">The <span class="T1">TimeValue</span> function returns the type Variant with VarType 7 (Date); this value is stored internally as a double-precision number between 0 and 0.9999999999.</p>
  23.   <p class="Paragraph">As opposed to the <span class="T1">DateSerial</span> or <span class="T1">DateValue</span> function, in which serial date values are calculated resulting in days relative to a fixed date, you can calculate with values returned by the <span class="T1">TimeValue</span> function, but you cannot evaluate them.</p>
  24.   <p class="Paragraph">In the <span class="T1">TimeSerial</span> function, you can pass the individual parameters (hour, minute, second) as separate numeric expressions. For the <span class="T1">TimeValue</span> function, however, you can pass a string as a parameter containing the time.</p>
  25.   <p class="Paragraph"><span class="T1">Example:</span></p>
  26.   <p class="PropText">Sub ExampleTimerValue</p>
  27.   <p class="PropText">Dim daDT as Date</p>
  28.   <p class="PropText">Dim a1, b1, c1, a2, b2, c2 as String</p>
  29.   <p class="PropText">a1 = "start time"</p>
  30.   <p class="PropText">b1 = "end time"</p>
  31.   <p class="PropText">c1 = "total time"</p>
  32.   <p class="PropText"/>
  33.   <p class="PropText">a2 = "8:34"</p>
  34.   <p class="PropText">b2 = "18:12"</p>
  35.   <p class="PropText">daDT = TimeValue(b2) - TimeValue(a2)</p>
  36.   <p class="PropText">c2 = a1 & ": " & a2 & chr(13)</p>
  37.   <p class="PropText">c2 = c2 & b1 & ": " & b2 & chr(13)</p>
  38.   <p class="PropText">c2 = c2 & c1 & ": " & trim(Str(Hour(daDT))) & ":" & trim(Str(Minute(daDT))) & ":" & trim(Str(Second(daDT)))</p>
  39.   <p class="PropText">Msgbox c2</p>
  40.   <p class="PropText">end sub</p>
  41.   <p class="PropText"/>
  42.  </body></html>