# Verbrauch in Kategorie

> Symcon Dokumentation · Deutsch · erzeugt am 2026-09-26  
> Index: https://www.symcon.de/de/llms.txt

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/energie/verbrauch-in-kategorie/

_Benötigt Symcon >= 6.3_

Berechnet den Verbrauch in Prozent pro frei wählbarer Kategorie nach angegebener Start- und Enddatum. Die Berechnung basiert auf der täglichen Aggregation.

### Funktionsumfang

* Auswahl mehrere Variablen
* Freitext für Kategorie

### Software-Installation

* Über den Module Store das 'Verbrauch in Kategorie'-Modul installieren.

### Einrichten der Instanzen in IP-Symcon

 Unter 'Instanz hinzufügen' kann das 'Verbrauch in Kategorie'-Modul mithilfe des Schnellfilters gefunden werden.
	- Weitere Informationen zum Hinzufügen von Instanzen in der [Dokumentation der Instanzen](https://www.symcon.de/service/dokumentation/konzepte/instanzen/#Instanz_hinzufügen)

__Konfigurationsseite__:

| Name      | Beschreibung                                                          |
| --------- | --------------------------------------------------------------------- |
| Intervall | Intervall, in welchem die Berechnung ausgeführt wird. 0 = Deaktiviert |
| Quellen   | Liste der Variablen und Kategorien                                    |

### Statusvariablen

Die Statusvariablen/Kategorien werden automatisch angelegt. Das Löschen einzelner kann zu Fehlfunktionen führen.

#### Statusvariablen

| Name      | Typ     | Beschreibung                                                                                                                                                                                                                                                                   |
| --------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Kategorie | Float   | Pro Kategorie wird eine Variable angelegt, in welchem der Prozentuale Verbrauch angezeigt wird. Der Kategoriename wird intern auf A-Z, a-z, 0-9 und _ (Unterstrich) reduziert. Das bedeutet, dass die Kategorie "Test" und "Test €" ebenfalls auf "Test" kategorisiert werden. |
| Startzeit | Integer | Datum von wann die Berechnung starten soll                                                                                                                                                                                                                                     |
| Endzeit   | Integer | Datum bis wann die Berechnung gehen soll                                                                                                                                                                                                                                       |

## VIK_CalculationConsumption

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/energie/verbrauch-in-kategorie/vik-calculationconsumption/

`bool VIK_CalculateConsumption(int $InstanzID)`

_Benötigt Symcon >= 6.3_

Berechnet die Kategorien neu

**Parameter**

- `$InstanzID` (int): Id der Instanz

**Rückgabewert** (bool): Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis** TRUE**, andernfalls **FALSE**.

Id der Instanz

**Beispiel**

```php
VIK_CalculateConsumption(12345);
```