The function converts a 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 the 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