Promotic
WikipediaLinkedInYoutubeTwitterFacebook

SetValueByTime - metoda objektu PmTrend

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) veličiny (více veličin) 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:
SetValueByTime(vData As Variant, sWhat As String, tTime As Date, nTimeType As Long, sParam As String) As Boolean
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 veličin parametru sWhat. Pořadí veličin v řetězci sWhat určuje pořadí hodnot v poli vData, pokud je veličin v řetězci sWhat definováno více. Pokud obsahuje sWhat jen jedinou veličinu, je vData buď jednoduchá hodnota nebo pole s jedinou položkou.
sWhat(String) Specifikace veličiny (nebo veličin), 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 veličin ze záložky Data.

U veličin je nutno zachovat pořadí dle pořadí v záložce. Například pokud je pořadí veličin 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 veličin 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 dle místního nastavení)
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 PmTrend objektem 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 veličin s časovou známkou 14:15.
Vrácená hodnota:
Pokud záznam byl podle času nalezen a zápis byl proveden v pořadku, vrací true, jinak false.
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, je hodnota veličiny a0 odpovídající tomuto času přepsána hodnotou parametru vData(0) a hodnota veličiny a1 přepsána hodnotou parametru vData(1).
Dim vData, tTime
vData = Array(10,20)
'nastavení času tTime
If oTrend.SetValueByTime(vData, "a0;a1", tTime, 1, "eq:1sec") Then
  'veličiny a0,a1 přepsány hodnotami 10,20 úspěšně.
End If
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice