Porovnávané verzie
porovnané s
Kľúč
- Tento riadok sa pridal
- Riadok je odstránený.
- Formátovanie sa zmenilo.
Komentár:
D2D-5297 Podporenie UTC offsetu v zobrazovacej maske
Funkcia %TimeToStrEx
Funkcia
Funkcia konvertuje absolútny čas na textový reťazec podľa zadanej masky.
Deklarácia
| Blok kódu | ||||
|---|---|---|---|---|
| ||||
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 |
|---|---|
| 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
| Blok kódu | ||||
|---|---|---|---|---|
| ||||
%TimeToStrEx(M.TiA_01, "hh:mi:ss.mss dd-mm-rrrr") |