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).
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);
Dim val, vTime, oTView, oPoints
Set oTView = pMe
Set 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);
oTView.TimeSetType = 2
vTime = "..."
' jest "czas zimowy"
val = oPoints.GetValueByTime(vTime, 0, 1)