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
string1Textový reťazec.
string2Maska.
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") 
Napíšte komentár