> For the complete documentation index, see [llms.txt](https://support.powerio.com/hub/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.powerio.com/hub/codesys-hvac/hvac-library/functionblocks/clock/holiday.md).

# Holiday

## `Holiday` (FB)

FUNCTION\_BLOCK Holiday

### Kurzbeschreibung

> Definition von 10 Ferienzeiträumen (= Kanäle) mit Einschalt- und Auschaltdaten.\
> Typische Anwendung: Uhrsystem

### Darstellung

<figure><img src="/files/xCZoqKTbtouIKwiSHH3S" alt=""><figcaption></figcaption></figure>

### Schnittstellen

#### Eingänge

| Name  | Datentyp | Wertebereich | Initialwert | Funktion                                                                    |
| ----- | -------- | ------------ | ----------- | --------------------------------------------------------------------------- |
| *xEN* | BOOL     |              |             | Freigabe / Sperrung der Ferienzeiträume (FALSE = Sperrung, TRUE = Freigabe) |

#### Ausgänge

| Name            | Datentyp | Wertebereich | Initialwert | Funktion                                                                          |
| --------------- | -------- | ------------ | ----------- | --------------------------------------------------------------------------------- |
| *xActive*       | BOOL     |              |             | Zustand der Ferienzeiträume (FALSE = nicht aktiv, TRUE = aktiv)                   |
| *datActiveFrom* | DATE     |              |             | Einschaltdatum des letzten aktiven Ferienzeitraums (Kanal 10 = höchste Priorität) |
| *datActiveTo*   | DATE     |              |             | Ausschaltdatum des letzten aktiven Ferienzeitraums (Kanal 10 = höchste Priorität) |

#### Sollwerte / Parameter

| Name                  | Datentyp | Wertebereich | Initialwert   | Funktion                                                         |
| --------------------- | -------- | ------------ | ------------- | ---------------------------------------------------------------- |
| **xCh10\_Mode**       | BOOL     |              | TRUE          | Freigabe / Sperrung Kanal 10 (FALSE = Sperrung, TRUE = Freigabe) |
| **datCH10\_DateFrom** | DATE     |              | DATE#2019-1-1 | Einschaltdatum Kanal 10                                          |
| **datCH10\_DateTo**   | DATE     |              | DATE#2019-1-1 | Ausschaltdatum Kanal 10                                          |
| **sCH10\_Notice**     | STRING   |              | ‘Notice’      | Bezeichnung für Kanal 10                                         |
| **xCh9\_Mode**        | BOOL     |              | TRUE          | Freigabe / Sperrung Kanal 9 (FALSE = Sperrung, TRUE = Freigabe)  |
| **datCH9\_DateFrom**  | DATE     |              | DATE#2019-1-1 | Einschaltdatum Kanal 9                                           |
| **datCH9\_DateTo**    | DATE     |              | DATE#2019-1-1 | Ausschaltdatum Kanal 9                                           |
| **sCH9\_Notice**      | STRING   |              | ‘Notice’      | Bezeichnung für Kanal 9                                          |
| **xCh8\_Mode**        | BOOL     |              | TRUE          | Freigabe / Sperrung Kanal 8 (FALSE = Sperrung, TRUE = Freigabe)  |
| **datCH8\_DateFrom**  | DATE     |              | DATE#2019-1-1 | Einschaltdatum Kanal 8                                           |
| **datCH8\_DateTo**    | DATE     |              | DATE#2019-1-1 | Ausschaltdatum Kanal 8                                           |
| **sCH8\_Notice**      | STRING   |              | ‘Notice’      | Bezeichnung für Kanal 8                                          |
| **xCh7\_Mode**        | BOOL     |              | TRUE          | Freigabe / Sperrung Kanal 7 (FALSE = Sperrung, TRUE = Freigabe)  |
| **datCH7\_DateFrom**  | DATE     |              | DATE#2019-1-1 | Einschaltdatum Kanal 7                                           |
| **datCH7\_DateTo**    | DATE     |              | DATE#2019-1-1 | Ausschaltdatum Kanal 7                                           |
| **sCH7\_Notice**      | STRING   |              | ‘Notice’      | Bezeichnung für Kanal 7                                          |
| **xCh6\_Mode**        | BOOL     |              | TRUE          | Freigabe / Sperrung Kanal 6 (FALSE = Sperrung, TRUE = Freigabe)  |
| **datCH6\_DateFrom**  | DATE     |              | DATE#2019-1-1 | Einschaltdatum Kanal 6                                           |
| **datCH6\_DateTo**    | DATE     |              | DATE#2019-1-1 | Ausschaltdatum Kanal 6                                           |
| **sCH6\_Notice**      | STRING   |              | ‘Notice’      | Bezeichnung für Kanal 6                                          |
| **xCh5\_Mode**        | BOOL     |              | TRUE          | Freigabe / Sperrung Kanal 5 (FALSE = Sperrung, TRUE = Freigabe)  |
| **datCH5\_DateFrom**  | DATE     |              | DATE#2019-1-1 | Einschaltdatum Kanal 5                                           |
| **datCH5\_DateTo**    | DATE     |              | DATE#2019-1-1 | Ausschaltdatum Kanal 5                                           |
| **sCH5\_Notice**      | STRING   |              | ‘Notice’      | Bezeichnung für Kanal 5                                          |
| **xCh4\_Mode**        | BOOL     |              | TRUE          | Freigabe / Sperrung Kanal 4 (FALSE = Sperrung, TRUE = Freigabe)  |
| **datCH4\_DateFrom**  | DATE     |              | DATE#2019-1-1 | Einschaltdatum Kanal 4                                           |
| **datCH4\_DateTo**    | DATE     |              | DATE#2019-1-1 | Ausschaltdatum Kanal 4                                           |
| **sCH4\_Notice**      | STRING   |              | ‘Notice’      | Bezeichnung für Kanal 4                                          |
| **xCh3\_Mode**        | BOOL     |              | TRUE          | Freigabe / Sperrung Kanal 3 (FALSE = Sperrung, TRUE = Freigabe)  |
| **datCH3\_DateFrom**  | DATE     |              | DATE#2019-1-1 | Einschaltdatum Kanal 3                                           |
| **datCH3\_DateTo**    | DATE     |              | DATE#2019-1-1 | Ausschaltdatum Kanal 3                                           |
| **sCH3\_Notice**      | STRING   |              | ‘Notice’      | Bezeichnung für Kanal 3                                          |
| **xCh2\_Mode**        | BOOL     |              | TRUE          | Freigabe / Sperrung Kanal 2 (FALSE = Sperrung, TRUE = Freigabe)  |
| **datCH2\_DateFrom**  | DATE     |              | DATE#2019-1-1 | Einschaltdatum Kanal 2                                           |
| **datCH2\_DateTo**    | DATE     |              | DATE#2019-1-1 | Ausschaltdatum Kanal 2                                           |
| **sCH2\_Notice**      | STRING   |              | ‘Notice’      | Bezeichnung für Kanal 2                                          |
| **xCh1\_Mode**        | BOOL     |              | TRUE          | Freigabe / Sperrung Kanal 1 (FALSE = Sperrung, TRUE = Freigabe)  |
| **datCH1\_DateFrom**  | DATE     |              | DATE#2019-1-1 | Einschaltdatum Kanal 1                                           |
| **datCH1\_DateTo**    | DATE     |              | DATE#2019-1-1 | Ausschaltdatum Kanal 1                                           |
| **sCH1\_Notice**      | STRING   |              | ‘Notice’      | Bezeichnung für Kanal 1                                          |

### Funktionsbeschreibung

#### Allgemeines

Dieser Funktionsbaustein wertet maximal 10 frei definierbare Ferienzeiträume (= Kanäle) aus.\
Ist die Auswertung generell freigegeben (*xEN* = TRUE), so wird bei allen aktivierten Ferienzeiträumen (**xChX\_Mode** = TRUE, 0 < X < 11) geprüft, ob das aktuelle Datum innerhalb des Ferienzeitraums liegt. Ist dies bei mindestens einem aktivierten Ferienzeitraum der Fall, so wird der Ausgang *xActive* aktiviert (= TRUE).\
In allen übrigen Fällen wird der Ausgang *xActive* deaktiviert (= FALSE).\
Liegt das Ausschaltdatum zeitlich vor dem Einschaltdatum (Kanäle 1 - 10), so wird intern das Ausschaltdatum mit dem Einschaltdatum gleich gesetzt.\
Ist das Einschalt- und Ausschaltdatum eines Kanals (Kanäle 1 - 10) identisch, so wird dieser Tag als Ferientag bewertet.\
An den Ausgängen *datActiveFrom* bzw. *datActiveTo* stehen (Voraussetzung: *xEN* = TRUE) das Einschaltdatum / Ausschaltdatum des Kanals 10 zur Verfügung.

> **Voraussetzung für den Einsatz des Funktionsbausteins Holiday**
>
> Zur korrekten Funktion ist der Einsatz des Funktionsbausteins TimeRead2 erforderlich.

### Visualisierung

Passendes Visualisierungselement aus der HVACV Visu Library: **Holidays**

#### Darstellung

<figure><img src="/files/qSKYJo9tsh9xrPNmcv9F" alt=""><figcaption></figcaption></figure>

#### Schnittstellen Visu-Element

| Name             | Datentyp | Typ          | Initialwert | Funktion                                                                                                                                                                                                                                                                                                                                               |
| ---------------- | -------- | ------------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **FB\_Holiday**  | Holiday  | VAR\_IN\_OUT |             | Hier FB Holiday eintragen Bsp. PRG.Holiday                                                                                                                                                                                                                                                                                                             |
| **BMS\_Active**  | BOOL     | VAR\_INPUT   |             | BMS (Building Management System) GLT (Gebäudeleittechnik). Wenn BMS\_Active = TRUE wird die Eingabe/Editierung der Uhren deaktiviert da diese dann nur über das BMS eingestellt werden können. Uhrzeiten können dann nur angeschaut werden.                                                                                                            |
| **DisableInput** | BOOL     | VAR\_INPUT   |             | DisableInpput = TRUE Uhrzeiten der Wochenuhren können nur angesehen werden und nicht editiert werden./// - BMS (Building Management System) GLT (Gebäudeleittechnik). Wenn BMS\_Active = TRUE wird die Eingabe/Editierung der Uhren deaktiviert da diese dann nur über das BMS eingestellt werden können. Uhrzeiten können dann nur angeschaut werden. |

\
Hinweis: VAR\_IN\_OUT Schnittstellen müssen belegt werden, VAR\_INPUT sind optional.

### CODESYS

InOut:

| Scope       | Name               | Type     | Initial       |
| ----------- | ------------------ | -------- | ------------- |
| Input       | `xEn`              | `BOOL`   |               |
| Input Const | `sCH1_Notice`      | `STRING` | ‘Notice’      |
| Input Const | `datCH1_DateTo`    | `DATE`   | DATE#2022-1-1 |
| Input Const | `datCH1_DateFrom`  | `DATE`   | DATE#2022-1-1 |
| Input Const | `xCH1_Mode`        | `BOOL`   | TRUE          |
| Input Const | `sCH2_Notice`      | `STRING` | ‘Notice’      |
| Input Const | `datCH2_DateTo`    | `DATE`   | DATE#2022-1-1 |
| Input Const | `datCH2_DateFrom`  | `DATE`   | DATE#2022-1-1 |
| Input Const | `xCH2_Mode`        | `BOOL`   | TRUE          |
| Input Const | `sCH3_Notice`      | `STRING` | ‘Notice’      |
| Input Const | `datCH3_DateTo`    | `DATE`   | DATE#2022-1-1 |
| Input Const | `datCH3_DateFrom`  | `DATE`   | DATE#2022-1-1 |
| Input Const | `xCH3_Mode`        | `BOOL`   | TRUE          |
| Input Const | `sCH4_Notice`      | `STRING` | ‘Notice’      |
| Input Const | `datCH4_DateTo`    | `DATE`   | DATE#2022-1-1 |
| Input Const | `datCH4_DateFrom`  | `DATE`   | DATE#2022-1-1 |
| Input Const | `xCH4_Mode`        | `BOOL`   | TRUE          |
| Input Const | `sCH5_Notice`      | `STRING` | ‘Notice’      |
| Input Const | `datCH5_DateTo`    | `DATE`   | DATE#2022-1-1 |
| Input Const | `datCH5_DateFrom`  | `DATE`   | DATE#2022-1-1 |
| Input Const | `xCH5_Mode`        | `BOOL`   | TRUE          |
| Input Const | `sCH6_Notice`      | `STRING` | ‘Notice’      |
| Input Const | `datCH6_DateTo`    | `DATE`   | DATE#2022-1-1 |
| Input Const | `datCH6_DateFrom`  | `DATE`   | DATE#2022-1-1 |
| Input Const | `xCH6_Mode`        | `BOOL`   | TRUE          |
| Input Const | `sCH7_Notice`      | `STRING` | ‘Notice’      |
| Input Const | `datCH7_DateTo`    | `DATE`   | DATE#2022-1-1 |
| Input Const | `datCH7_DateFrom`  | `DATE`   | DATE#2022-1-1 |
| Input Const | `xCH7_Mode`        | `BOOL`   | TRUE          |
| Input Const | `sCH8_Notice`      | `STRING` | ‘Notice’      |
| Input Const | `datCH8_DateTo`    | `DATE`   | DATE#2022-1-1 |
| Input Const | `datCH8_DateFrom`  | `DATE`   | DATE#2022-1-1 |
| Input Const | `xCH8_Mode`        | `BOOL`   | TRUE          |
| Input Const | `sCH9_Notice`      | `STRING` | ‘Notice’      |
| Input Const | `datCH9_DateTo`    | `DATE`   | DATE#2022-1-1 |
| Input Const | `datCH9_DateFrom`  | `DATE`   | DATE#2022-1-1 |
| Input Const | `xCH9_Mode`        | `BOOL`   | TRUE          |
| Input Const | `sCH10_Notice`     | `STRING` | ‘Notice’      |
| Input Const | `datCH10_DateTo`   | `DATE`   | DATE#2022-1-1 |
| Input Const | `datCH10_DateFrom` | `DATE`   | DATE#2022-1-1 |
| Input Const | `xCH10_Mode`       | `BOOL`   | TRUE          |
| Output      | `xActive`          | `BOOL`   |               |
| Output      | `datActiveFrom`    | `DATE`   |               |
| Output      | `datActiveTo`      | `DATE`   |               |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://support.powerio.com/hub/codesys-hvac/hvac-library/functionblocks/clock/holiday.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.