# Betriebsstundenzähler

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

_Benötigt Symcon >= 5.2_

Mithilfe des Betriebsstundenzähler-Moduls kann die Betriebszeit eines Gerätes ermittelt und angezeigt werden.

### Funktionsumfang
- Anzeige der Stunden, welche ein Gerät aktiv ist
- Hinzufügen des Geräts durch eine Variable vom Typ Boolean
- Anzeigen der Kosten für den aktuellen, den letzten Zeitraum und Vorhersage für das Ende des Zeitraums
- Möglichkeit die Kosten mit einem dynamischen Preis zu berechnen

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

### Einrichten der Instanzen in IP-Symcon
- Unter 'Instanz hinzufügen' kann das 'Betriebsstundenzähler'-Modul mithilfe des Schnellfilters gefunden werden.
    - Weitere Informationen zum Hinzufügen von Instanzen in der [Dokumentation der Instanzen](/service/dokumentation/konzepte/instanzen/#Instanz_hinzufügen)

#### Konfigurationsseite

| Name                     | Beschreibung                                                                                                                                                                               |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Aktiv                    | Legt fest ob die Rechnung auf Basis des eingestellten Intervalls aktualisiert wird                                                                                                         |
| Quelle                   | Die Variable vom Typ Boolean, welche den Aktivitätsstatus eines Gerätes anzeigt, wobei true als aktiv angesehen wird. Um die Betriebsstunden zu errechnen muss diese Variable geloggt sein |
| Stufe                    | Die Stufe legt den Beginn des Zeitraums fest welcher betrachtet wird (Beginn des Tages, Woche, Monat, Jahr) sowie die Aggregationsstufe                                                    |
| Aktualisierungsintervall | Das Intervall in Minuten in dem die Betriebszeit erneut berechnet wird                                                                                                                     |
| Kostenberechnung         | Legt fest ob die Kostenberechnung ausgeführt werden                                                                                                                                        |
| Preistyp                 | Option, ob der Preis fest gelegt ist oder dynamisch über eine Variable berechnet werden soll                                                                                               |
| Preis                    | Der Preis welcher pro Betriebsstunde berechnet wird                                                                                                                                        |
| Berechnen                | Berechnet die Betriebszeit mit allen angegebenen Parametern                                                                                                                                |

Ist im Preistyp die Option "Dynamisch" eingestellt, wird eine geloggte Variable gefordert, welche den Kostenpreis beinhaltet.

### Statusvariablen und Profile

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

#### Statusvariablen

| Name                             | Typ   | Beschreibung                                                               |
| -------------------------------- | ----- | -------------------------------------------------------------------------- |
| Betriebsstunden                  | float | Die berechneten Betriebsstunden der Quellvariable im ausgewählten Zeitraum |
| Kosten des jetzigen Zeitraums    | float | Die berechneten Kosten des laufenden Zeitraums                             |
| Kosten des letzten Zeitraums     | float | Die berechneten Kosten des letzten abgeschlossenen Zeitraums               |
| Vorhersge zum Ende des Zeitraums | float | Vorhersage der Kosten zum Ende des laufenden Zeitraums                     |

#### Profile

| Name               | Typ   |
| ------------------ | ----- |
| BSZ.OperatingHours | float |

### Visualisierung
Im Webfront werden die Betriebsstunden angezeigt.

## BSZ_Calculate

Quelle: https://www.symcon.de/de/service/dokumentation/modulreferenz/energie/betriebsstundenzaehler/bsz-calculate/

`void BSZ_Calculate(int $InstanzID)`

_Benötigt Symcon >= 5.2_

**Parameter**

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

**Rückgabewert** (void): Keine Rückgabe.

ID der Instanz

**Beispiel**

```text
BSZ_Calculate(12345);
```