Štatistiky a Info o hodnote

Okrem samotnej hodnoty zariadenia môže premenná skriptu obsahovať štatistiku zariadenia alebo informácie o hodnote: kedy sa naposledy zmenila, jej predchádzajúcu hodnotu a hodnoty ukončených období. Obe sa vyberajú vo výbere hodnoty zariadenia v editore skriptu.

Štatistiky#

Okrem samotných hodnôt zariadenia ponúka výber hodnoty zariadenia aj jeho štatistiky (sekcia Štatistiky): štatistiky, ktoré na zariadení zapol používateľ alebo ktoré poskytuje samo zariadenie, napríklad minimum, maximum, priemer, počet alebo súčet hodnoty za obdobie. Takto vybraná premenná obsahuje hodnotu tejto štatistiky:

• Štatistika typu Aktuálne obdobie, napríklad priemer aktuálnej hodiny, sa počíta od začiatku prebiehajúceho obdobia — hodiny, dňa alebo mesiaca — až po súčasnosť.
• Štatistika typu Obdobie do teraz, napríklad priemer za posledných 24 hodín, sa počíta v kĺzavom okne zadanej dĺžky, ktoré končí teraz.

# Se je vybraná ako hodinový priemer zariadenia Teplota (aktuálne obdobie)
IF Se > 25
    RETURN(1);
END
0;

Hodnoty ukončených období nie sú súčasťou samotnej štatistiky; prečítajte ich z Info o hodnote štatistiky.

Info o hodnote#

Vstupné premenné smart rules typu Rovnica, Vzorec a Skript, obmedzujúcej podmienky typu Vzorec a textov notifikácií sa dajú vybrať aj ako Info o hodnote; výber ich ponúka ako Info o hodnote názov hodnoty, a to pre samotnú hodnotu zariadenia aj pre štatistiku typu Aktuálne obdobie. Taká premenná neobsahuje číslo, ale informácie o hodnote:

Info o hodnote neobsahuje samotnú hodnotu. Ak chcete pracovať s hodnotou aj s informáciami o nej, pridajte hodnotu zariadenia do skriptu dvakrát: raz ako hodnotu (napríklad Se) a raz ako Info o hodnote (napríklad SeInfo).

Dostupnosť — TapHome Next 2026.1.36599+.

Aktuálna a predchádzajúca hodnota#

Current opisuje poslednú zmenu hodnoty:

Current je Null, kým sa hodnota prvý raz nezmení — pred čítaním jeho vlastností ho overte funkciou ISNULL.

Príklad — okno otvorené dlhšie ako 10 minút

# Wi = okenný kontakt (1 = otvorené), WiInfo = Info o hodnote okenného kontaktu
IF ISNULL(WiInfo.Current)
    RETURN(0);
END
IF Wi = 1 AND WiInfo.Current.CurrentValueTime < DATETIMEADD(NOW(), 0, 0, 0, 0, -10)
    RETURN(1);
END
0;

Príklad — stúpa hodnota, alebo klesá

# Se = Teplota, SeInfo = Info o hodnote zariadenia Teplota
IF ISNULL(SeInfo.Current) OR ISNULL(SeInfo.Current.LastKnownValue)
    RETURN(0);
END
VAR change := Se - SeInfo.Current.LastKnownValue;
IF change > 0
    RETURN(1);
ELSEIF change < 0
    RETURN(-1);
END
0;

História štatistiky#

Pri štatistike typu Aktuálne obdobie obsahuje History hodnoty období, ktoré sa už skončili:

Koľko období sa uchováva, závisí od obdobia štatistiky a od toho, či má zapnutý záznam histórie — prepínač histórie štatistiky na stránke Štatistiky zariadenia:

Pri každom inom období (1, 2, 3 a 30 minút, 12 hodín, 2 a 3 dni, 1 týždeň, 1 štvrťrok) a pri štatistike typu Obdobie do teraz je History Null. Values môže mať menej prvkov, než je počet uchovávaných období, napríklad krátko po zapnutí štatistiky — pred čítaním indexu, ktorý nemusí existovať, overte LENGTH.

Príklad — dnešná spotreba doteraz v porovnaní s celým včerajškom

# En = denný súčet zariadenia Energia (aktuálne obdobie), EnInfo = Info o hodnote tej istej štatistiky
VAR yesterday := GETAT(EnInfo.History.Values, 0);
IF ISNULL(yesterday)
    RETURN(NaN);
END
En - yesterday;

Príklad — priemerná denná spotreba za posledných 7 dní

# EnInfo = Info o hodnote denného súčtu zariadenia Energia (aktuálne obdobie)
AVG(COPY(EnInfo.History.Values, 0, MIN(7, LENGTH(EnInfo.History.Values))));

COPY vezme prvých 7 dní — MIN pokryje históriu kratšiu ako 7 dní, pretože COPY za koncom kolekcie je chyba — a AVG preskočí dni bez dát. MIN, MAX a AVG preskakujú Null, takže celú históriu možno použiť aj priamo:

# SeInfo = Info o hodnote hodinového maxima zariadenia Teplota (aktuálne obdobie)
MAX(SeInfo.History.Values);
# Result: the highest temperature of the kept hours

Pozrite aj — Premenné a konštanty, MIN, MAX a AVG, COPY.