Funkcia konvertuje absolútny čas na textový reťazec podľa zadanej masky.
Deklarácia
TEXT %TimeToStrEx(
TIME in TimeA,
TEXT in maska,
TEXT in timeZone := %GetCurrentTimeZone()
)
Parametre
TimeA
Absolútny čas.
maska
Formát času vo výslednom reťazci.
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]]", kdehhurčuje počet hodín,mipočet minút asspoč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!
Poznámka
Poloha jednotlivých zložiek času je daná výskytom nasledovných reťazcov v zadanej maske.
Reťazec
Význam reťazca
rrrr alebo yyyy
Štvorciferné vyjadrenie roku.
rr alebo yy
Posledné dve číslice roku.
mm
Mesiac
dd
Deň
hh
Hodina
hb, HH
Obchodná hodina - poradová hodina v dni od 1 do 25.
Posun v hodinách a minútach voči UTC vo formáte "(+|-)hhmi".
ZZZZZZ
Posun v hodinách a minútach voči UTC vo formáte "(+|-)hh:mi".
Funkcia je zhodná s funkciou %TimeToStr, okrem rozdielov pri prevode nejednoznačného času - zmena letného času na zimný a naopak - funkcia zobrazuje čas s pridaním znaku A alebo B podľa toho, či čas patril do letného alebo zimného času.
Znaky A a B sa pridávajú pre prechodnú hodinu, ktorá je závislá na použitom časovom pásme. V časovom pásme GTM+1 je to o druhej hodine ráno lokálneho času, v časovom pásme GMT+2 je to o tretej hodine ráno lokálneho času a pod.