GetValueByTime - metoda objektu tvPoints
Popis:
Vyhledá hodnotu (více hodnot) datového bodu podle zadaných parametrů.
Syntaxe:
Variant GetValueByTime(Variant vTime, Variant nStyle, Long nCount)
Parametry:
| vTime | (Variant) Čas, podle kterého mají být vyhledány datové body
Čas je předpokládán podle nastavení vlastnosti PmgTrendViewer.TimeSetType tzn. "lokální čas", "zimní čas" nebo "letní čas". |
|---|
| nStyle | (Variant) Typ určení bodu vzhledem k času vTime
0 - Hledá se datový bod, jehož čas je menší nebo rovno vTime
1 - Hledá se datový bod, jehož čas je větší nebo rovno vTime
2 - Hledá se časově nejbližší datový bod času vTime |
|---|
| nCount | (Long) Počet vrácených hodnot.
1 - Vrací jednu hodnotu datového bodu
>1 - Vrací nCount hodnot v poli (není implementováno v jazyce JavaScript) |
|---|
Vrácená hodnota:
Metoda vrací hodnotu (pole hodnot) nalezeného bodu.
Pokud není nalezen takový bod, pak metoda vrací:
null pro
JavaScript nebo
Empty pro
VBScript (lze testovat metodou
Pm.IsValid).
Příklad1:
Čas má být zadáván jako "lokální čas" ("zimní čas" v zimním období a "letní čas" v letním období).:
JavaScriptVBScriptVyber a zkopíruj do schránky
var val, vTime;
var oTView = pMe;
var oPoints = oTView.Trends("t1").Points;
oTView.TimeSetType = 1;
vTime = "...";
// je "lokální čas"
val = oPoints.GetValueByTime(vTime, 0, 1);
Dim val, vTime, oTView, oPoints
Set oTView = pMe
Set oPoints = oTView.Trends("t1").Points
oTView.TimeSetType = 1
vTime = "..."
' je "lokální čas"
val = oPoints.GetValueByTime(vTime, 0, 1)Příklad2:
Čas má být zadán jako "zimní čas" a to i v letním období:
JavaScriptVBScriptVyber a zkopíruj do schránky
oTView.TimeSetType = 2;
vTime = "...";
// je "zimní čas"
val = oPoints.GetValueByTime(vTime, 0, 1);
oTView.TimeSetType = 2
vTime = "..."
' je "zimní čas"
val = oPoints.GetValueByTime(vTime, 0, 1)