clock-timer

Opis

Bloczek clock-timer służy do określania, czy aktualna pora dnia mieści się w ustawionym przedziale godzinowym. Działa według lokalnego czasu urządzenia i nie wymaga żadnych wejść.

Bloczek ma dwa parametry konfiguracyjne: godzinę rozpoczęcia i godzinę zakończenia. Gdy aktualny czas mieści się w ustawionym przedziale, bloczek jest aktywny. Gdy aktualny czas znajduje się poza tym przedziałem, bloczek jest nieaktywny.

Przedział może działać na dwa sposoby:

• jeśli godzina rozpoczęcia jest wcześniejsza niż godzina zakończenia, bloczek jest aktywny między tymi godzinami tego samego dnia, na przykład od 08:00 do 16:30
• jeśli godzina rozpoczęcia jest późniejsza niż godzina zakończenia, aktywność przechodzi przez północ, na przykład 22:00 do 06:00

Godzina rozpoczęcia jest wliczana do okresu aktywnego, a godzina zakończenia już nie. W praktyce zmiana stanu następuje kilka sekund po osiągnięciu ustawionej minuty.

Opis widoczny pod bloczkiem pokazuje bieżący stan i czas następnej zmiany, na przykład active until 16:30 albo inactive until 08:00.

Parametry konfiguracyjne

Nazwa parametru	Wartość
Godzina rozpoczęcia (startHour)	Obowiązkowa godzina w formacie HH:MM. Określa początek okresu aktywnego. Dozwolony zakres to od 00:00 do 23:59.
Godzina zakończenia (endHour)	Obowiązkowa godzina w formacie HH:MM. Określa koniec okresu aktywnego. Dozwolony zakres to od 00:00 do 23:59.

Obie godziny muszą być różne. Ustawienie takich samych wartości początku i końca powoduje błąd konfiguracji.

Obsługa wejścia

Bloczek clock-timer nie posiada wejść i nie reaguje na sygnały z innych bloczków.

Wyjścia bloczka

Numer i nazwa wyjścia	Opis wyjścia
1. Wyjście aktywności.	Zwraca wartość true, gdy aktualny czas mieści się w skonfigurowanym przedziale aktywnym. Poza tym przedziałem zwraca false.
2. Wyjście nieaktywności.	Zwraca wartość przeciwną do wyjścia nr 1, czyli true, gdy bloczek jest poza przedziałem aktywnym, oraz false, gdy bloczek jest aktywny.

Oba wyjścia są typu logicznego i zmieniają się równocześnie przy zmianie stanu bloczka.

Błędy widoczne dla użytkownika

Bloczek może pokazywać następujące komunikaty błędów:

Kod błędu	Opis błędu
Invalid start time configuration.	Parametr startHour ma niepoprawną wartość. Należy podać godzinę w formacie HH:MM, z zakresem od 00:00 do 23:59.
Invalid end time configuration.	Parametr endHour ma niepoprawną wartość. Należy podać godzinę w formacie HH:MM, z zakresem od 00:00 do 23:59.
Start time equals end time.	Godzina rozpoczęcia i godzina zakończenia są identyczne. Aby bloczek działał poprawnie, obie wartości muszą się różnić.

Przykłady działania

• Dla startHour = 08:00 i endHour = 16:30 wyjście nr 1 jest aktywne od 08:00 do 16:30, a następnie kilka sekund po 16:30 przechodzi na false.
• Dla startHour = 22:00 i endHour = 06:00 wyjście nr 1 jest aktywne wieczorem i w nocy, a kilka sekund po 06:00 przechodzi na false.
• Dla startHour = 00:00 i endHour = 00:01 bloczek jest aktywny tylko przez pierwszą minutę każdej doby i wyłącza się kilka sekund po 00:01.