clock-info

Opis

Bloczek clock-info udostępnia aktualne informacje o lokalnej dacie i czasie urządzenia. Korzysta ze strefy czasowej ustawionej w głównym kalendarzu systemu, ale działa niezależnie od tego, czy obsługa programów kalendarza jest włączona.

Wartości są odświeżane co sekundę. Niezmienione wartości nie są ponownie wysyłane. Opis pod bloczkiem pokazuje czas lokalny bez sekund w formacie YYYY-MM-DD HH:MM, na przykład 2026-07-08 14:37, dlatego zmiana samych sekund nie odświeża opisu.

Bloczek nie jest harmonogramem. Nie rozróżnia dni roboczych, weekendów ani świąt.

Parametry konfiguracyjne

Bloczek clock-info nie posiada parametrów konfiguracyjnych.

Obsługa wejścia

Bloczek clock-info nie posiada wejść i nie reaguje na sygnały z innych bloczków. Nie występują więc dane wejściowe ignorowane ani nieprawidłowe.

Wyjścia bloczka

Wszystkie wyjścia liczbowe są typu integer. Wyjście nr 8 jest typu bool.

Numer i nazwa wyjścia	Opis wyjścia
1. rok	Pełny rok kalendarzowy, na przykład 2026.
2. miesiąc	Numer miesiąca w zakresie 1-12.
3. dzień miesiąca	Numer dnia miesiąca w zakresie 1-31.
4. godzina	Godzina w formacie 24-godzinnym, w zakresie 0-23.
5. minuta	Minuta w zakresie 0-59.
6. sekunda	Sekunda w zakresie 0-59.
7. numer dnia tygodnia	Numer dnia tygodnia: 1 = poniedziałek, ..., 7 = niedziela.
8. czy rok przestępny	true, gdy bieżący rok jest przestępny; w przeciwnym razie false.
9. numer tygodnia w roku	Numer tygodnia według ISO-8601, w zakresie 1-53.
10. numer tygodnia w miesiącu	Numer tygodnia według zasady pierwszego poniedziałku, w zakresie 0-5.
11. numer dnia w roku	Numer dnia w roku, w zakresie 1-365 albo 1-366 w roku przestępnym.
12. liczba dni w miesiącu	Liczba dni w bieżącym miesiącu, z uwzględnieniem 29 dni lutego w roku przestępnym.
13. numer pory roku	Meteorologiczna pora roku: 1 = zima, 2 = wiosna, 3 = lato, 4 = jesień.

Rok przestępny

Rok jest przestępny, gdy jest podzielny przez 400 albo jest podzielny przez 4, ale nie przez 100. Dzięki temu na przykład rok 2000 jest przestępny, rok 2100 nie jest przestępny, a rok 2024 jest przestępny. Ta sama reguła wpływa na wyjścia czy rok przestępny, numer dnia w roku i liczba dni w miesiącu.

Numer tygodnia w roku

Numer tygodnia jest zgodny z ISO-8601. Tydzień zaczyna się w poniedziałek, a tydzień nr 1 jest tygodniem zawierającym pierwszy czwartek roku. Czwartek jest punktem odniesienia jako „środek ciężkości” tygodnia. Z tego powodu pierwsze dni stycznia mogą należeć do tygodnia nr 52 albo 53 poprzedniego roku, a ostatnie dni grudnia do tygodnia nr 1 następnego roku. Wyjście podaje wyłącznie numer tygodnia, bez roku tygodnia ISO.

Numer tygodnia w miesiącu

Tydzień zaczyna się w poniedziałek. Pierwszy poniedziałek występujący w miesiącu rozpoczyna tydzień nr 1. Jeżeli miesiąc nie zaczyna się w poniedziałek, początkowe dni przed pierwszym poniedziałkiem mają numer tygodnia 0. Każdy kolejny poniedziałek zwiększa numer o 1, a końcowe dni miesiąca zachowują numer nadany przez ostatni poniedziałek.

Numer pory roku

Pory roku są meteorologiczne i zależą wyłącznie od miesiąca:

• zima (1): grudzień, styczeń i luty
• wiosna (2): marzec, kwiecień i maj
• lato (3): czerwiec, lipiec i sierpień
• jesień (4): wrzesień, październik i listopad

Błędy widoczne dla użytkownika

W przypadku błędu wszystkie wyjścia przyjmują wartość null. Bloczek nie wysyła ponownie niezmienionych wartości null.

Kod błędu	Opis błędu
Time unavailable.	Nie udało się odczytać albo przeliczyć lokalnego czasu. Bloczek ponawia próbę i po poprawnym odczycie wraca do zwykłej pracy.
Timer error.	Nie udało się zaplanować kolejnego odświeżenia danych czasu.

Przykłady działania

• Dla lokalnego czasu 2026-07-08 14:37:05 bloczek zwraca między innymi: rok 2026, miesiąc 7, dzień miesiąca 8, godzinę 14, minutę 37, sekundę 5, środę jako dzień tygodnia 3, tydzień ISO 28, tydzień miesiąca 1, dzień roku 189, 31 dni w miesiącu i lato jako porę roku 3. Rok przestępny ma wartość false.
• Dla daty 2024-02-29 wyjście czy rok przestępny ma wartość true, numer dnia w roku wynosi 60, a liczba dni w miesiącu wynosi 29.
• Dla daty 2021-01-01 numer tygodnia ISO wynosi 53, ponieważ ten dzień należy do ostatniego tygodnia ISO poprzedniego roku. Numer tygodnia w miesiącu wynosi 0, ponieważ pierwszy poniedziałek stycznia przypada dopiero 4 stycznia.