%StrToTimeEx function

Old name
%MkATEx


Function
The function converts a text string to a value of Absolute time type according to a given mask.
Declaration


TIME %StrToTimeEx(
   TEXT in String1, 
   TEXT in String2,
   TEXT in timeZone := %GetCurrentTimeZone()
 )


Parameters


string1Text string.
string2Mask.
timeZone


Description
In case of an ambiguous time, the function returns standard time (i.e. later time). Ambiguous time can be labeled with the character A - for daylight-saving time and B - for standard time.

The ambiguous time is distinguished by the characters A and B (A - summer time and B - standard time), in the place of hours. For example: In time zone GMT+1 at 2 a.m. of the local time, the ambiguous time is defined as A2 and B2. In time zone GMT+2 at 3 a.m. of the local time, it is defined as A3 and B3, etc.

For a time that is missing or does not exist, it returns invalid value.

Example


%StrToTimeEx("17:03:16 18-03-99",  "hh:mi:ss dd-mm-rr")


Implemented functions
Function arguments - types