Funkcia %TimeToStrMono

Funkcia
Funkcia vráti čas ako monotónny čas v časovom pásme UTC+posun vo forme textového reťazca naformátovaného podľa zadanej masky.
Deklarácia
TEXT %TimeToStrMono(
   TIME in TimeA,
   TEXT in maska,
   INT in offset
 )
Parametre
TimeAAbsolútny čas.
maskaFormát času vo výslednom reťazci.
offsetPosun v sekundách pridaný k UTC monotónnemu času.
Popis
Posun pripočítaný k času v časovom pásme UTC sa udáva v sekundách. Napríklad pre zobrazenie času v stredoeurópskom časovom pásme (SEČ) je potrebné nastaviť posun na hodnotu 3600 sekúnd (1 hodina), čo predstavuje časové pásmo UTC+1. Poloha jednotlivých zložiek času vo forme textu je daná výskytom nasledovných reťazcov v zadanej maske:

ReťazecVýznam reťazca
rrrr alebo yyyyŠtvorciferné vyjadrenie roka.
rr alebo yyPosledné dve číslice roka.
mmMesiac
ddDeň
hhHodina
miMinúta
ssSekunda
mssMilisekunda

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.
Príklad
 ; =================================================================
 ;  Slovakia (country for this example)
 ;  Time zone is UTC+1.
 ;  There are summer [A] and winter [B] time (with time shifts).
 ;  Summer time is from 29. March 2009 to 24. October 2009.
 ; =================================================================
 
 BEGIN
 
  TIME _timeB
  TEXT _txtTimeB
 
  TIME _timeA
  TEXT _txtTimeA
 
  ; winter time
  _timeB := %StrToTimeEx("14:30:00 1.1.2009", "hh:mi:ss dd-mm-rrrr")
  ; UTC 13:30:00 01-01-2009, result 14:30:00 01-01-2009
  _txtTimeB := %TimeToStrMono(_timeB, "hh:mi:ss dd-mm-rrrr", 3600)
 
  ; summer time
  _timeA := %StrToTimeEx("14:30:00 1.8.2009", "hh:mi:ss dd-mm-rrrr")
  ; UTC 12:30:00 01-08-2009, result 13:30:00 01-08-2009
  _txtTimeA := %TimeToStrMono(_timeA, "hh:mi:ss dd-mm-rrrr", 3600)
 
 END

Súvisiace stránky:

Implementované funkcie
Argumenty funkcie - typy

Napíšte komentár