Funkcia vracia hodnotu nasledujúcej časovej značky, ktorá je novšia ako aktuálny čas. Hodnota časovej značky je daná periódou Period a časovým posunom Offset, ktoré sa udávajú v sekundách. Výsledkom je absolútny čas.
Deklarácia
TIME %NextTime(
INT in Period,
INT in Offset,
UNIVAL in CalcTrigger,
TEXT in timeZone := %GetCurrentTimeZone()
)
Parametre
Period
Perióda [s] - musí byť kladné číslo.
Offset
Parameter určujúci posun (offset) [s] - môže byť aj záporné číslo.
CalcTrigger
Výpočtový trigger je objekt, ktorého zmena spôsobí prepočítanie funkcie. Môže byť ľubovoľného typu. Trigger má zmysel iba pri použití v počítaných bodoch, v rámci ESL skriptov je ignorovaný. Pozn: parameter vznikol, keď ešte neexistovali počítané body s definovaným triggrom. Ak treba vykonať prepočet pri zmene konkrétneho objektu, použite počítaný bod s triggrom.
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!
0 komentárov