Datum und Zeit
Seit 0.1.11 enthält die Kategorie sieben zusätzliche Blocks. Alle Blocks mit Bildern. Die Oberfläche verwendet die originale Blockly-Library; die Übersetzung nach HA-Jinja ist eine eigene UGSo-Implementierung. Referenz sind die Zeit-Blocks des ioBroker-JavaScript-Adapters und die Blockly-Blockdefinitionen.
ioBroker / UGSo Blocks für HA
| ioBroker | Unser Block / Umsetzung |
|---|---|
| Aktuelle Zeit ist …, feste Uhrzeit | Uhrzeitvergleich mit kleiner, kleiner/gleich, größer, größer/gleich, gleich, zwischen und nicht zwischen. Das Endfeld erscheint bei Zeiträumen. |
| Aktuelle Zeit mit Checkbox und andockbarem Wert | Uhrzeitvergleich mit Eingängen: Text-Blocks für Start/Ende. Haken aus: zusätzlicher Datumswert-Anschluss für die zu vergleichende Zeit. |
| Aktuelle Zeit als Datum-Objekt oder formatierter Wert | Aktuelle Zeit als Datumswert und separater Formatierungsblock. Diese Trennung verhindert, dass formatierte Texte versehentlich als Datumswerte verrechnet werden. |
| Berechnete Zeit | Kalenderbeginn: Tag, nächster Tag, Woche (Montag), Monat und Jahr. Weitere ioBroker-Kalendergrenzen sind noch nicht vorhanden. |
| Aktuelle Zeit von Astroereignis plus Offset | Nächste Sonnenzeit: Aufgang, Untergang, Morgen-/Abenddämmerung, Höchststand und Sonnenmitternacht, mit positivem/negativem Minutenoffset. |
| Zeit berechnen, Basis ± Zahl, Einheit | Zeit berechnen: Datumswert ± Zahl; Millisekunden, Sekunden, Minuten, Stunden oder Tage. |
Anschlüsse und Bedienung
Zeitvergleiche liefern Boolean und passen in Bedingungen, UND/ODER/NICHT oder Falls. Datumswerte besitzen einen Time-Anschluss: Aktuelle Zeit, Kalenderbeginn, Sonnenzeit und Zeitberechnung lassen sich untereinander verschachteln. Zahlen gehören in Offset/Betrag; formatierte Uhrzeiten als Text in die andockbaren Vergleichsgrenzen. Formatierung bietet HH:mm, HH:mm:ss, ISO-Datum, deutsches Datum, Datum/Uhrzeit, ISO mit Zeitzone und Unix-Sekunden.
Beispiel: Aktuelle Zeit → Zeit berechnen (+ 30 Minuten) → Zeit formatieren (HH:mm), anschließend als Variable setzen. Das erzeugte Template lautet:
{{ (now() + timedelta(minutes=30)).strftime("%H:%M") }}Zwischen 22:00 und 06:00 schließt die Nacht über Mitternacht ein. Der Start gehört dazu, das Ende nicht. Gleiche Grenzen bedeuten einen leeren Zeitraum; „nicht zwischen“ ist dessen Gegenteil. Feste Uhrzeiten müssen HH:mm oder HH:mm:ss sein. Dynamische Textgrenzen müssen zur Laufzeit dasselbe Format liefern; ungültige Werte erzeugen einen HA-Template-Fehler. Der Vergleich arbeitet auf Sekunden; „gleich 12:00“ bedeutet 12:00:00 und ist kein zuverlässiger Zeit-Auslöser.
Ausführung und Grenzen
Die erzeugten Templates werden in Home Assistant ausgewertet. Der Browser baut das YAML und führt keine eigene laufende Zeitsteuerung aus. Die Funktionen verwenden die konfigurierte HA-Zeitzone: HA-Datums-/Zeitfunktionen. Kalenderbeginn nutzt lokale Mitternacht; Tage folgen der lokalen Kalenderrechnung, auch bei Sommerzeitwechsel. Eine Rechnung „+ 24 Stunden“ garantiert bei einem Zeitwechsel keine 24 real verstrichenen UTC-Stunden.
Sonnenwerte kommen aus den Attributen der HA-Sun-Integration. Diese liefern das nächste Ereignis, nicht stets das Ereignis des heutigen Tages. Die UTC-Angabe wird vor Berechnung/Formatierung in HA-Ortszeit umgewandelt. Fehlende Werte, etwa bei nicht verfügbarer Integration oder einem nicht berechenbaren Ereignis, ergeben einen Template-Fehler; es wird keine Ersatzzeit erfunden.
Ein Zeitvergleich prüft die Uhrzeit beim Durchlaufen der Bedingung. Er startet die Automation nicht und wartet nicht bis zur passenden Uhrzeit. Dafür einen Uhrzeit- oder Sonnen-Auslöser verwenden. Der neue Sonnenwert-Block ersetzt keinen Sonnen-Auslöser.
Blocks-Projekt (JSON) erhält Form, Auswahl und dynamische Eingänge. Beim YAML-Öffnen bleiben diese Zeittemplates inhaltlich erhalten, erscheinen aber als allgemeine Template-Blocks. Ein zuvor in einer HA-Variable gespeicherter Datumswert kann als Text vorliegen; unser Variablen-Leseblock hat deshalb keinen Time-Anschluss. Datumswerte direkt verschachteln oder seit 0.1.12 den Variablen-Leseblock über Nach Datum/Zeit konvertieren. Konvertierung und Einheiten. Konvertierte Laufzeitzahlen können jetzt auch in Betrag und Sonnenoffset andocken.
Prüfung: Blockly-/YAML-Rundläufe, typisierte Anschlüsse, dynamische Felder sowie Jinja-Prüfungen für Nachtgrenzen und Sommerzeit. Eine Ausführung auf einem echten HA-System ist noch nicht verifiziert.