# Verbrauch in Zeitspanne

> 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-zeitspanne/

_Benötigt Symcon >= 4.2_

### Funktionsumfang
- Berechnet für eine Zeitspanne den Verbrauch anhand der Aggregation der ausgewählten Quellvariable.
- Bei Änderung der Zeitspanne wird der Verbrauch neu ermittelt
- Verschiedene Detailgerade für Start- und End-Datum
- Einstellbares Intervall für die Aktualisierung der Berechnung

### Software-Installation
- Über den [Module Store](https://www.symcon.de/de/service/dokumentation/komponenten/verwaltungskonsole/module-store/) das Modul Verbrauch in Zeitspanne installieren.

### Einrichten der Instanzen in IP-Symcon
- Unter "Instanz hinzufügen" kann das 'Verbrauch in Zeitspanne'-Modul mithilfe des Schnellfilters gefunden werden.
  - Weitere Informationen zum Hinzufügen von Instanzen in der [Dokumentation der Instanzen](https://www.symcon.de/de/service/dokumentation/komponenten/verwaltungskonsole/module-store/)

#### Konfigurationsseite:

| Name                               | Beschreibung                                                                                           |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------ |
| Quelle                             | Quellvariable, die für Verbrauch genutzt werden soll                                                   |
| Detailgrad                         | Legt fest wie genau der Start- und Endzeitpunkt festgelegt werden kann (Datum, Uhrzeit, Datum/Uhrzeit) |
| Intervall zum Aktualisieren nutzen | Wenn aktiv, wird ein Intervall zum Aktualisieren der Berechnung genutzt                                |
| Intervall                          | Das Intervall in Minuten, in dem die Berechnung aktualisiert wird                                      |

> **Hinweis:** Wird im Detailgrad Datum ausgewählt, wird das Startdatum mit der Uhrzeit 00:00 und das Enddatum mit der Uhrzeit 23:59:59 genutzt.

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

#### Statusvariablen

| Name      | Typ     | Beschreibung                                                              |
| --------- | ------- | ------------------------------------------------------------------------- |
| Start     | Integer | Start-Datum/Start-Zeit für den Verbrauch (Sekunden werden nicht beachtet) |
| Ende      | Integer | End-Datum/End-Zeit für den Verbrauch (Sekunden werden nicht beachtet)     |
| Verbrauch | Float   | Verbrauch zwischen Start- und End-Datum                                   |

## VIZ_Calculate

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/energie/verbrauch-in-zeitspanne/viz-calculate/

`bool VIZ_Calculate(int $InstanzID)`

_Benötigt Symcon >= 4.2_

**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**

```text
VIZ_Calculate(12345);
```