Funkcia %TimeToStrEx

Funkcia

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]]", 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!

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

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.
mi	Minúta
ss	Sekunda
mss	Milisekunda
tttt	Názov dňa v týždni *.
ttt	Trojpísmenková skratka názvu dňa v týždni *.
tt	Dvojpísmenková skratka názvu dňa v týždni *.
ZZZ	Posun v hodinách voči UTC vo formáte "(+\|-)hh".
ZZZZZ	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.

Príklad: A2:10:00 26-10-2003 (pre časové pásmo GMT+1)

Ak formátovacia maska obsahuje komponent UTC posunu, tak syntax A/B sa pre nejednoznačné časy nepoužije.

Príklad

%TimeToStrEx(M.TiA_01, "hh:mi:ss.mss dd-mm-rrrr")

Súvisiace stránky:

Implementované funkcie
Argumenty funkcie - typy