%StrMonoToTime function

Function
The function converts given text to an absolute time.
Declaration
TIME  %StrMonoToTime(
   TEXT in txtTime
   TEXT in txtMask
   INT in offset
 )

Parameters
txtTime Text string that contains a time.
txtMask Time mask used for recognition of items of a time defined by parameter txtTime.
offset Time offset [s].

Description
The function converts a time in text form to a time by defined mask. It assumes that time in text form is a monotonic one, with an offset (defined by the parameter offset) compared to UTC.
Example
TEXT _tTxt
 TIME _t
 
 BEGIN
 ; conversion of monotonic standard time in text form to time
 ; for standard time
 _t := %StrMonoToTime("04:00:00 01-01-2005",  "hh:mi:ss dd-mm-rrrr", 3600)
 _tTxt :=   %TimeToStrEx(_t,  "hh:mi:ss dd-mm-rrrr") ; gets the value of "04:00:00 01-08-2005"
 
 ; for day-light saving time
 _t :=   %StrMonoToTime("04:00:00 01-08-2005",  "hh:mi:ss dd-mm-rrrr", 3600)
 _tTxt :=   %TimeToStrEx(_t,  "hh:mi:ss dd-mm-rrrr") ; gets the value of "05:00:00 01-08-2005"
 END

Related pages:

Implemented functions
Function arguments - types

Napíšte komentár