SetValueByTime - metoda objektu PmaTrendGroup

Popis:

Metoda vyhledá podle parametru tTime záznam s časovou známkou a pokud je takový záznam nalezen, pak do něj zapíše hodnotu (pole hodnot) proměnné (více proměnných) z parametru vData. Časová známka záznamu je vyhledána dle parametrů tTime a sParam a může se od času parametru tTime lišit, nanejvýš ale o zadanou přesnost. Viz popisy parametrů.

Syntaxe:

Boolean SetValueByTime(Variant vData, String sWhat, Date tTime, Long nTimeType, String sParam)

Volání:

retval = oTrend.SetValueByTime(vData, sWhat, tTime, nTimeType, sParam)

Parametry:

vData	(Variant) Hodnota nebo pole hodnot. Počet hodnot jednoznačně odpovídá počtu zadaných proměnných parametru sWhat. Pořadí proměnných v řetězci sWhat určuje pořadí hodnot v poli vData, pokud je proměnných v sWhat definováno více. Pokud obsahuje sWhat jen jedinou proměnnou, pak je vData buď jednoduchá hodnota nebo pole s jedinou položkou.
sWhat	(String) Specifikace proměnné (nebo proměnných), jejíž uchovaná(é) hodnota(y) mají být přepsány. Lze zadat například "a1;" nebo "a1;a2;a3;", pokud se má zapisovat do pole proměnných ze záložky Data. U proměnných je nutno zachovat pořadí podle pořadí v záložce. Například pokud je pořadí proměnných v záložce a1,a2,a3,..., pak v parametru lze zadat například "a1;a3;", ale "a3;a1" je chybně.
tTime	(Date) Čas, jehož záznam hodnot proměnných má být vyhledán.
nTimeType	(Long) Typ času v parametru tTime 1 - tTime je "lokální čas" ("zimní čas" v zimním období a "letní čas" v letním období, odpovídá času počítače podle místního nastavení systému Windows) 2 - tTime je "zimní čas" (v letním i v zimním období).
sParam	(String) Způsob vyhledání času zadaného v parametru tTime. "eq:xxx" - Hledá se záznam, jehož časová známka je rovna času tTime. Řetězec xxx určuje přesnost rovnosti. Pro xxx jsou dovoleny hodnoty Nsec, Nmin, kde N je reálné číslo udávající počet sekund resp. počet minut. Pokud jsou například objektem PmaTrendGroup uchovány hodnoty 15 sekundové (...,14:00,14:15,14:30,...), pak při zadání tTime=14:17, sParam="eq:3sec" bude nalezen záznam proměnných s časovou známkou 14:15.

Vrácená hodnota:

Pokud záznam byl podle času nalezen a zápis byl proveden v pořadku, pak vrací true, v jiném případě false.

Viz také:

- GetValueByTime

- GetData

- Jak pracovat s polem hodnot v systému PROMOTIC

Příklad:

Vyhledává se záznam podle času tTime. Časová známka záznamu se může lišit od času tTime maximálně o 1 sekundu. Pokud je záznam nalezen, pak je hodnota proměnné a0 odpovídající tomuto času přepsána hodnotou parametru vData(0) a hodnota proměnné a1 přepsána hodnotou parametru vData(1).

JavaScriptVBScriptVyber a zkopíruj do schránky


var vData, tTime;
vData = Pm.CreatePmArray().Array1(10, 20);

//nastavení času tTime
if (oTrend.SetValueByTime(vData, "a0;a1", tTime, 1, "eq:1sec"))
	//proměnné a0,a1 byly přepsány hodnotami 10,20 úspěšně.