Porovnávané verzie

Kľúč

  • Tento riadok sa pridal
  • Riadok je odstránený.
  • Formátovanie sa zmenilo.
Komentár: parameter timeZone

Funkcia %TimeToStrEx


Funkcia
Funkcia konvertuje absolútny čas na textový reťazec podľa zadanej masky.
Deklarácia


Blok kódu
languageesl
themeConfluence
TEXT %TimeToStrEx(
   TIME in TimeA,
   TEXT in maska,
   INT TEXT in timeZone :=  %GetTimeZone%GetCurrentTimeZone()
 )
Parametre


TimeAAbsolútny čas.
maskaFormát času vo výslednom reťazci.
timeZone
Vynútené časové pásmo
Názov časového pásma pre prevod na lokálny čas
. Zadáva sa ako posun časového pásma od UTC v zimnom čase v sekundách.
(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ť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 *.

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)
Príklad


Blok kódu
languageesl
themeRDark
 %TimeToStrEx(M.TiA_01, "hh:mi:ss.mss dd-mm-rrrr")