%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. See the description of the mask for the %TimeToStr function Note: "UNIX" and "UNIXMS" masks are also supported for Unix timestamp conversion (number of seconds or milliseconds from 1.1.1970 UTC)
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")

Related pages: