Feiertagschaltuhr

Mit diesem Funktionsblock wird eine Feiertags Schaltuhr realisiert. Die Feiertage kann der Baustein selbst berechnen oder aus einer ICal Datei (*.ics) laden, die von einem Server geladen wird - auch beides gemeinsam. Bei der Berechnung braucht die Steuerung keine Internetverbindung: die festen Feiertage sind je Land und Bundesland bzw. Kanton hinterlegt, die beweglichen Feiertage wie Ostern, Christi Himmelfahrt, Pfingsten und Fronleichnam werden aus dem Osterdatum berechnet.

Eingänge

Freigabe

Optionale Freigabe. Ist an diesem Eingang nichts verknüpft, ist die Uhr automatisch freigegeben. Ansonsten nur wenn am Eingang ein Wert 1 anliegt.

Ausgänge

A1-x

Ausgang 1-x

Ausgänge. An allen Ausgängen wird der selbe Wert ausgegeben.

Feiertag morgen

Nur vorhanden, wenn der Parameter "Vorschau-Ausgänge" eingeschaltet ist. Ist der morgige Tag ein Feiertag, wird Wert ein ausgegeben, ansonsten Wert aus. Damit lässt sich zum Beispiel eine Heizung schon am Vortag umstellen.

Tage bis zum nächsten Feiertag

Nur vorhanden, wenn der Parameter "Vorschau-Ausgänge" eingeschaltet ist. Anzahl der Tage bis zum nächsten Feiertag. 0 bedeutet, dass heute ein Feiertag ist, 1 bedeutet morgen. Folgt in den nächsten Monaten kein Feiertag oder ist die Uhr nicht freigegeben, wird -1 ausgegeben.

Parameter

Quelle

Woher die Feiertage kommen:

Berechnung: Die Feiertage werden aus Land und Bundesland bzw. Kanton berechnet. Es wird nichts aus dem Internet geladen.
iCal Datei: Die Feiertage kommen wie bisher aus der unter "URL ICal Datei" angegebenen Datei.
Berechnung + iCal: Beide Quellen gelten gemeinsam. Damit lassen sich die berechneten Feiertage um eigene Termine ergänzen, zum Beispiel Betriebsurlaub, Schulferien oder Gemeindefeiertage, die sich nicht aus einer Regel ergeben.

In Projekten, die mit einer älteren Version angelegt wurden, steht die Quelle auf "iCal Datei" - dort ändert sich nichts. Neu angelegte Bausteine starten mit "Berechnung".

Land

Österreich, Deutschland, Schweiz oder Italien. Nur bei der Berechnung sichtbar.

Bundesland / Kanton

Bestimmt die regionalen Feiertage. Mit "Landesweit" gelten nur die Tage, die im ganzen Land gefeiert werden. Nur bei der Berechnung sichtbar.

Achtung: Beim Wechsel des Landes werden Bundesland und Auswahl zurückgesetzt, weil sie zum neuen Land nicht mehr passen.

Feiertage

Öffnet über die Schaltfläche "..." die Auswahl der Feiertage. Dort kann jeder Tag einzeln an- und abgewählt werden, auch Zusatztage wie der 24. und der 31. Dezember. Zu jedem Tag stehen das berechnete Datum für dieses und das nächste Jahr sowie die Art des Tages:

gesetzlich: arbeitsfreier Feiertag im ganzen Land.
gesetzlich, regional: arbeitsfreier Feiertag in der gewählten Region.
teilweise (gemeindeweise): gilt in der Region nur in einzelnen Gemeinden. Diese Tage sind nicht vorausgewählt, sie müssen vor Ort geprüft werden.
Schul-/Landesfeiertag: kein gesetzlicher Feiertag nach dem Arbeitsruhegesetz, aber Schulen und Ämter bleiben geschlossen. Nicht vorausgewählt.
Zusatztag: kein Feiertag, kann bei Bedarf zusätzlich ausgewählt werden. Nicht vorausgewählt.

Wird nichts geändert, gelten alle gesetzlichen Feiertage der gewählten Region. Nur bei der Berechnung sichtbar.

Anzahl Ausgänge

Anzahl der Ausgänge.

Wert ein/aus

Ist die Schaltzeit erreicht, wird Wert ein an den Ausgängen ausgegeben, ansonsten Wert aus.

URL ICal Datei

URL von der die ics Datei geladen wird. Die Datei wird automatisch 1x pro Tag von diesem Server geladen. Diese können beispielsweise von Internet Seiten geladen werden welche ICal Dateien bereitstellen (z.B. https://www.ferienwiki.at) und auf einem eigenen Server bereitgestellt werden.

Folgende Kalenderquellen werden unterstützt:

Google Kalender: Google Kalender im Browser am Computer öffnen (nicht in der Handy-App), rechts oben Zahnrad > "Einstellungen", dann links unter "Einstellungen für meine Kalender" den gewünschten Kalender anklicken. Im Abschnitt "Kalender integrieren" die "Öffentliche Adresse im iCal-Format" bzw. "Geheime Adresse im iCal-Format" kopieren und einfügen.
Apple iCloud Kalender: Den Kalender öffentlich freigeben und den Freigabelink (beginnt mit webcal://...) einfügen. Der Weg dorthin je nach Gerät:
- iPhone/iPad: Kalender-App öffnen, unten auf "Kalender" tippen, dann auf das Info-Symbol (i) neben dem gewünschten iCloud-Kalender. Die Option "Öffentlicher Kalender" aktivieren, auf "Link teilen" tippen und den Link kopieren (z.B. per "Kopieren" oder an sich selbst senden).
- Mac: In der Kalender-App mit der rechten Maustaste auf den Kalender in der Seitenleiste klicken und "Kalender freigeben ..." wählen (oder auf das Symbol neben dem Kalendernamen klicken). "Öffentlicher Kalender" ankreuzen, dann mit Rechtsklick auf den Kalender "URL kopieren" wählen.
- iCloud.com im Browser: Kalender öffnen, in der Seitenleiste auf das Teilen-Symbol neben dem Kalender klicken, "Öffentlicher Kalender" aktivieren und den angezeigten Link kopieren.
Hinweise: Öffentlich freigeben lassen sich nur iCloud-Kalender (keine in der Apple Kalender-App eingebundenen Google- oder Exchange-Kalender). Jeder, der den Link kennt, kann die Termine dieses Kalenders lesen - daher am besten einen eigenen Kalender nur für die Schaltzeiten anlegen. Der webcal://-Link kann unverändert eingefügt werden.
Google Drive: Eine ics Datei in Google Drive ablegen, für "Jeder mit dem Link" freigeben und den Freigabelink einfügen.
Dropbox: Eine ics Datei in Dropbox ablegen und den Freigabelink einfügen.
Beliebige http/https/webcal Adressen, die direkt eine ics Datei liefern.

Freigabelinks werden automatisch in Download-Adressen umgesetzt. Die Datei muss mit BEGIN:VCALENDAR beginnen. Termine mit jährlicher Wiederholung werden unterstützt, andere Wiederholungsregeln (z.B. wöchentlich) nicht. Bei Terminen mit Uhrzeit zählt der gesamte Tag. Kann der Server nicht erreicht werden oder liefert er eine fehlerhafte Antwort, bleibt die zuletzt geladene Datei erhalten.

Die Dateien können Feiertage für mehrere Jahre enthalten. Zudem kann die URL einen Platzhalter für das Jahr enthalten (%YYYY), dieser wird beim Laden durch die aktuelle Jahreszahl ersetzt. Dadurch können auf einem eigenen Server mehrere Jahre vorab bereitgestellt werden.

Fertige Feiertagskalender von Google:
Google stellt für die meisten Länder öffentliche Feiertagskalender bereit. Die Adresse kann direkt eingefügt werden, z.B.:

Österreich: https://calendar.google.com/calendar/ical/de.austrian%23holiday%40group.v.calendar.google.com/public/basic.ics
Deutschland: https://calendar.google.com/calendar/ical/de.german%23holiday%40group.v.calendar.google.com/public/basic.ics
Schweiz: https://calendar.google.com/calendar/ical/de.ch%23holiday%40group.v.calendar.google.com/public/basic.ics
Italien: https://calendar.google.com/calendar/ical/it.italian%23holiday%40group.v.calendar.google.com/public/basic.ics
Südtirol (italienische Feiertage in deutscher Sprache): https://calendar.google.com/calendar/ical/de.italian%23holiday%40group.v.calendar.google.com/public/basic.ics

Alternativ über die Google-Kalender-Oberfläche: Im Browser am Computer links unten bei "Weitere Kalender" auf das Plus-Zeichen klicken, "Relevante Kalender ansehen" wählen und unter "Regionale Feiertage" das gewünschte Land abonnieren. Danach in den Einstellungen den Feiertagskalender anklicken und unter "Kalender integrieren" die "Öffentliche Adresse im iCal-Format" kopieren.

Fertige Feiertagskalender von Apple:
Auch Apple stellt die aus iPhone/Mac bekannten Feiertagskalender öffentlich bereit (der im Gerät integrierte Kalender "Feiertage" selbst lässt sich nicht teilen, die zugrundeliegenden Adressen sind aber direkt abrufbar), z.B.:

Österreich: webcal://calendars.icloud.com/holidays/at_de.ics
Deutschland: webcal://calendars.icloud.com/holidays/de_de.ics
Schweiz: webcal://calendars.icloud.com/holidays/ch_de.ics
Italien: webcal://calendars.icloud.com/holidays/it_it.ics (nur in italienischer Sprache; für Südtirol in deutscher Sprache den Google-Kalender verwenden, siehe oben)

Das Adressmuster ist webcal://calendars.icloud.com/holidays/<land>_<sprache>.ics (z.B. fr_fr, es_es, us_en). Nicht für alle Länder verfügbar.

Adress-Generator:
Hier kann die Kalender-Adresse für alle EU-Länder und die Schweiz zusammengestellt werden. Land und Bundesland/Region wählen, dann die gewünschte Adresse kopieren und in den Parameter "URL ICal Datei" einfügen:

Land:
Bundesland/Region:
Google:
Apple:

Wichtig: Dieser Adress-Generator kann zukünftige Änderungen der Kalender-Adressen von Google und Apple nicht berücksichtigen. Funktioniert eine erzeugte Adresse nicht, beachten Sie bitte die aktuelle Dokumentation des jeweiligen Herstellers (Google Kalender-Hilfe bzw. Apple Support).

Hinweis: Die Feiertagskalender von Google und Apple enthalten teils auch nicht arbeitsfreie Anlässe (z.B. Valentinstag, Muttertag). Wer nur gesetzliche Feiertage schalten möchte, legt am besten einen eigenen Kalender an (siehe oben) und trägt die gewünschten Tage selbst ein - mit jährlicher Wiederholung genügt das einmalige Anlegen.

Vorschau-Ausgänge

Schaltet die beiden zusätzlichen Ausgänge "Feiertag morgen" (FM) und "Tage bis zum nächsten Feiertag" (TG) ein.

Achtung: Die beiden Ausgänge hängen hinten an den normalen Ausgängen. Wird der Parameter wieder ausgeschaltet, gehen die dort eingetragenen Adressen verloren. Wird nur die Anzahl der Ausgänge geändert, wandern die Adressen automatisch mit.

Die Ausgänge werden erst ab Version 2.3137 der Steuerung unterstützt.

Berechnete Feiertage

Bewegliche Feiertage werden aus dem Osterdatum berechnet: Karfreitag zwei Tage davor, Ostermontag einen Tag danach, Christi Himmelfahrt 39 Tage, Pfingstsonntag 49 Tage, Pfingstmontag 50 Tage und Fronleichnam 60 Tage nach Ostersonntag. Der Buß- und Bettag ist der Mittwoch vor dem 23. November, der eidgenössische Bettag der dritte Sonntag im September.

Österreich
Bundesweit gesetzlich: Neujahr, Heilige Drei Könige, Ostermontag, Staatsfeiertag, Christi Himmelfahrt, Pfingstmontag, Fronleichnam, Mariä Himmelfahrt, Nationalfeiertag, Allerheiligen, Mariä Empfängnis, Christtag und Stefanitag.
Der Karfreitag ist seit 2019 kein gesetzlicher Feiertag mehr, er wurde durch den persönlichen Feiertag ersetzt. Er steht deshalb nur als Zusatztag zur Verfügung.
Die Landespatrone (Hl. Josef, Hl. Florian, Hl. Rupert, Hl. Martin, Hl. Leopold) und der Kärntner Tag der Volksabstimmung sind keine Feiertage nach dem Arbeitsruhegesetz, sondern Schul- und Landesfeiertage.

Deutschland
Bundesweit gesetzlich: Neujahr, Karfreitag, Ostermontag, Tag der Arbeit, Christi Himmelfahrt, Pfingstmontag, Tag der Deutschen Einheit, 1. und 2. Weihnachtstag.
Regional gelten Heilige Drei Könige, Internationaler Frauentag, Fronleichnam, Mariä Himmelfahrt, Weltkindertag, Reformationstag, Allerheiligen und der Buß- und Bettag. In Brandenburg sind zusätzlich Oster- und Pfingstsonntag gesetzliche Feiertage.
Fronleichnam in Sachsen und Thüringen, Mariä Himmelfahrt in Bayern und das Augsburger Friedensfest gelten nur gemeindeweise und sind deshalb nicht vorausgewählt.
Der Berliner Tag der Befreiung am 8. Mai ist nicht hinterlegt, da er bisher nur einmalig galt. Er lässt sich über die Quelle "Berechnung + iCal" ergänzen.

Schweiz
Bundesrechtlich ist nur die Bundesfeier am 1. August geregelt, alles andere ist kantonal und teilweise sogar gemeindeweise festgelegt. Die Tabelle bildet den üblichen Stand ab.
Genf hat als einziger Kanton keinen eidgenössischen Bettag, dafür den Genfer Bettag am Donnerstag nach dem ersten Sonntag im September. In der Waadt kommt der Bettagsmontag dazu. Wallis und Tessin weichen bei Karfreitag, Oster- und Pfingstmontag ab. In Aargau, Freiburg, Graubünden und Solothurn sind viele Tage nur gemeindeweise arbeitsfrei; sie erscheinen als "teilweise" und sind nicht vorausgewählt.

Italien
Landesweit gesetzlich: Neujahr, Heilige Drei Könige, Ostersonntag, Ostermontag, Tag der Befreiung, Tag der Arbeit, Tag der Republik, Mariä Himmelfahrt, Allerheiligen, Mariä Empfängnis, Weihnachten und Stephanstag.
Karfreitag, Christi Himmelfahrt und Fronleichnam sind in Italien keine Feiertage. Der Pfingstmontag ist nur in der Autonomen Provinz Bozen (Südtirol) arbeitsfrei - dort ist als Region "Südtirol" zu wählen.
Der Patroziniumstag ist jeweils in der einzelnen Gemeinde arbeitsfrei. Die wichtigsten Stadtpatrone sind als "teilweise" hinterlegt und können bei Bedarf angehakt werden, alle übrigen lassen sich über die Quelle "Berechnung + iCal" ergänzen.

Maßgeblich ist immer die geltende Rechtslage. Die hinterlegten Regeln bilden den Stand zum Zeitpunkt der Auslieferung ab - ändert der Gesetzgeber einen Feiertag, muss die Auswahl angepasst oder die Quelle "Berechnung + iCal" genutzt werden.

Siehe auch allgemeine Parameter aller Funktionsbausteine.