If the time specified in the tTime parameter with the specified precision (in the sStyle parameter) is found, then the values of the required variables that meet the found time, are returned.
values = oTrend.GetValueByTime(sWhat,tTime,nTimeType,sStyle)
|sWhat||(String) Specification of the variable (or variables) whose stored value(s) has to be returned. It is possible to enter, for example: |
"a1;" or "a1;a2;a3;" if an array of the variables (with names a1..a3) of the "Data" tab has to be returned or
"time;" if even the time has to be returned.
At the variables it is necessary to keep the order by the order on the tab. For example, if the order of the variables is a1,a2,a3,... on the tab, then it is possible to enter, for example, "a1;a3;" in the parameter but "a3;a1" is wrong.
Time setting can be changed by entering "time:winter;" and then all time values are returned in the "standard time" otherwise they are in the "local time".
|tTime||(Date) Time whose record of variables values has to be searched.|
|nTimeType||(Long) Time type in the tTime parameter.|
1 - tTime is "local time" (the "standard time" in the standard season and the "daylight-saving time" in the daylight-saving season, corresponds to the computer time depending on the locale setting of Windows system)
2 - tTime is "standard time" (in the daylight-saving and standard seasons).
|sStyle||(String) Way of searching the time specified in the tTime parameter.|
"eq:xxx" - Record whose time mark equals the tTime time, is searched. The string xxx specifies the accuracy of the equality. For xxx the values Nsec, Nmin are enabled, where N is a real number that sets the number of seconds, respectively the number of minutes. If, for example, 15 seconds (...,14:00,14:15,14:30,...) values are stored by the PmaTrendGroup object, then after entering tTime=time 14:17, sStyle="eq:3sec", the record of variables with the time mark 14:15 will be found.
"newest" - The latest record is looked for. In the tTime parameter, the value 0 needs to be set.
"oldest" - The oldest record is looked for. In the tTime parameter, the value 0 needs to be set.
At the same time the method can return, together with the returned values, even the found time that can differ from the time in the tTime parameter but by the above mentioned accuracy at the most. See examples.
var values, tTime;
values = oTrend.GetValueByTime("time;a0;a1", tTime, 1, "eq:1sec");
var values, tTime;
values = oTrend.GetValueByTime("a0;a1", tTime, 1, "eq:1.5min");