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

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

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

Súvisiace stránky: