%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

string1	Text string.
string2	Mask.
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")