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


TimeAAbsolútny čas.
maskaFormát času vo výslednom reťazci.
timeZone


Poznámka
Poloha jednotlivých zložiek času je daná výskytom nasledovných reťazcov v zadanej maske.

ReťazecVýznam reťazca
rrrr alebo yyyyŠtvorciferné vyjadrenie roku.
rr alebo yyPosledné dve číslice roku.
mmMesiac
ddDeň
hhHodina
hb, HHObchodná hodina - poradová hodina v dni od 1 do 25.
miMinúta
ssSekunda
mssMilisekunda
ttttNázov dňa v týždni *.
tttTrojpísmenková skratka názvu dňa v týždni *.
ttDvojpísmenková skratka názvu dňa v týždni *.
ZZZPosun v hodinách voči UTC vo formáte "(+|-)hh".
ZZZZZPosun v hodinách a minútach voči UTC vo formáte "(+|-)hhmi".
ZZZZZZPosun v hodinách a minútach voči UTC vo formáte "(+|-)hh:mi".

Nahradzovaný je len prvý výskyt daného typu zložky času a v prípade výskytu viacerých dĺžok masky (napr. yy a yyyy) danej zložky času je nahradzovaná len tá najdlhšia.


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")