Promotic

GetValueByTime - metoda obiektu tvPoints

Opis:
Wyszuka wartość (kilku wartości) punktu danej według określonych parametrów.
Składnia:
Variant GetValueByTime(Variant vTime, Variant nStyle, Long nCount)
Parametry:
vTime(Variant) Czas, według którego mają być wyszukiwane punkty danych
Określenie czasu jest oczekiwane według ustawienia właściwości PmgTrendViewer.TimeSetType tzn. "czas lokalny", "czas zimowy" lub "czas letni".
nStyle(Variant) Typ określenia punktu w stosunku do czasu vTime
0 - Jest wyszukiwany punkt, którego czas jest mniejsze lub równe vTime
1 - Jest wyszukiwany punkt, którego czas jest większe lub równe vTime
2 - Jest wyszukiwany punkt, którego czas jest najbliżej do czasu vTime
nCount(Long) Ilość zwróconych wartości.
1 - Zwraca jedną wartość punktu danych
>1 - Zwraca nCount wartości w tablicy (nie jest implementowane w języku JavaScript)
Wartość zwrotna:
Metoda zwraca wartość (tablicę wartości) znalezionego punktu.
Jeżeli określony punkt nie zostanie odnaleziony, wtedy metoda zwraca: null dla JavaScript lub Empty dla VBScript (można sprawdzić przy pomocy metody Pm.IsValid).
Notatka:
Metoda ta działa także w Web panelach.
Patrz również:
Przykład1:
Czas ma być wprowadzany jako "czas lokalny" ("czas zimowy" w okresie zimowym oraz "czas letni" w okresie letnim).:
JavaScriptVBScriptWybierz oraz skopiuj do schowka

var val, vTime;
var oTView = pMe;
var oPoints = oTView.Trends("t1").Points;

oTView.TimeSetType = 1;
vTime = "...";   // jest "czas lokalny"
val = oPoints.GetValueByTime(vTime, 0, 1);
Przykład2:
Czas ma być wprowadzany jako "czas zimowy" także w okresie letnim:
JavaScriptVBScriptWybierz oraz skopiuj do schowka

oTView.TimeSetType = 2;
vTime = "...";   // jest "czas zimowy"
val = oPoints.GetValueByTime(vTime, 0, 1);
© MICROSYS, spol. s r.o.