Funkcia %StrToTimeEx

Starý názov funkcie

%MkATEx

Funkcia

Funkcia konvertuje textový reťazec (string) na hodnotu typu Absolútny čas podľa zadanej masky.

Deklarácia

TIME %StrToTimeEx(
   TEXT in string1,
   TEXT in string2,
   TEXT in timeZone := %GetCurrentTimeZone()
 )

Parametre

string1	Textový reťazec.
string2	Maska.
timeZone	Názov časového pásma pre prevod na lokálny čas (napr. "Europe/London") alebo definícia fixného posunu od UTC vo formáte "(+\|-)hh[:mi[:ss]]", kde hh určuje počet hodín, mi počet minút a ss počet sekúnd. Znamienko posunu a počet hodín sú povinné časti definície posunu, počet minút a sekúnd sú volitelné a predvolene sú 0 (napr. "+02:30" definuje posun 2 hodiny a 30 minút od UTC). Prázdny text je interpretovaný rovnako ako volanie funkcie %GetCurrentTimeZone. Z historických dôvodov je akceptovaný aj celočíselný parameter, ktorý je interpretovaný nasledovne: 0 - zóna "Europe/London", 3600 - zóna "Europe/Bratislava", 7200 - zóna "Europe/Kiev", 21600 - zóna "Asia/Almaty". Použitie celočíselného parametra sa neodporúča a generuje upozornenie do logovacieho súboru!

Popis

Funkcia pre dvojznačný čas vráti zimný čas (t.j. neskorší).

Dvojitý čas sa rozlišuje znakmi A - letný čas a B - zimný čas na mieste hodín. Napr.: V časovom pásme GMT+1 je dvojitý čas o druhej hodine lokálneho času rozlíšený ako A2 a B2. V časovom pásme GMT+2 je dvojitý čas o tretej hodine lokálneho času rozlíšený ako A3 a B3 a pod.

Pre chýbajúci alebo neexistujúci čas, funkcia vráti neplatnú hodnotu (invalid).

Príklad

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

Súvisiace stránky:

Implementované funkcie
Argumenty funkcie - typy