A calendar
A board for your base that shows today's date with the weekday and the week of the year, and how long it is until the next party.
Functions: DAY, MONTH, YEAR, WEEK and WEEKDAY, with NOW and DIV of c0de/math.
What you need
A trigger block with a button and a display wall of 3 × 1 display blocks (48 columns). Optionally a timer block instead of the button, to refresh the board by itself. For the second exercise, if you don't use the program runner: a variable item time of type TIME.
The idea
A TIME value knows the exact millisecond, but people read dates: "Thursday, 12 November 2026". The functions of c0de/time take a TIME apart into the numbers of the calendar, in the time zone of the server: DAY (1 to 31), MONTH (1 to 12), YEAR, WEEKDAY (1 for Monday to 7 for Sunday) and WEEK, the week of the year as many calendars in Europe count it. Arrays turn the numbers into names.
For the countdown you don't need the calendar at all. Two TIME values subtracted give the milliseconds between them, and a day has 86 400 000 of them.
The program
PROGRAM calendar
NOOP
INCLUDE c0de/time
INCLUDE c0de/math
CONSTANT EVENT_NAME STRING "Winter party"
CONSTANT EVENT TIME @2026-12-19T18:00:00Z
VARIABLE weekdays ARRAY STRING
BEGIN
"" "Monday" "Tuesday" "Wednesday" "Thursday" "Friday" "Saturday" "Sunday"
END VARIABLE
VARIABLE months ARRAY STRING
BEGIN
"" "January" "February" "March" "April" "May" "June"
"July" "August" "September" "October" "November" "December"
END VARIABLE
NOOP
FUNCTION describe
PARAMETER time TIME
RESULT text STRING
BEGIN
VARIABLE weekday INTEGER
VARIABLE day INTEGER
VARIABLE month INTEGER
VARIABLE year INTEGER
VARIABLE week INTEGER
CALL c0de/time/WEEKDAY
PARAMETER time time ;
RESULT result weekday
CALL c0de/time/DAY
PARAMETER time time ;
RESULT result day
CALL c0de/time/MONTH
PARAMETER time time ;
RESULT result month
CALL c0de/time/YEAR
PARAMETER time time ;
RESULT result year
CALL c0de/time/WEEK
PARAMETER time time ;
RESULT result week
ASSIGN text weekdays[weekday] ⊕ ", " ⊕ day ⊕ " " ⊕ months[month] ⊕ " " ⊕ year ⊕ " (week " ⊕ week ⊕ ")" ;
END FUNCTION
NOOP
FUNCTION countdown
PARAMETER from TIME
PARAMETER to TIME
RESULT days INTEGER
RESULT hours INTEGER
BEGIN
CALL c0de/math/DIV
PARAMETER dividend to - from ;
PARAMETER divisor 86400000 ;
RESULT result days
CALL c0de/math/DIV
PARAMETER dividend (to - from) \ 86400000 ;
PARAMETER divisor 3600000 ;
RESULT result hours
END FUNCTION
NOOP
FUNCTION board
BEGIN
VARIABLE now TIME
VARIABLE text STRING
VARIABLE days INTEGER
VARIABLE hours INTEGER
CALL c0de/time/NOW
RESULT result now
CALL describe
PARAMETER time now ;
RESULT text text
CALL CLS
CALL PRINT
PARAMETER value "Today is " ⊕ text ;
CALL describe
PARAMETER time EVENT ;
RESULT text text
CALL PRINT
PARAMETER value EVENT_NAME ⊕ ":" ;
CALL PRINT
PARAMETER value text ;
CALL countdown
PARAMETER from now ;
PARAMETER to EVENT ;
RESULT days days
RESULT hours hours
CALL PRINT
PARAMETER value days ⊕ " days and " ⊕ hours ⊕ " hours to go" ;
END FUNCTIONBuilding and running it
Bind the display wall to the program calendar and the function board. Set the trigger block to the same program and function and press the button. On 12 November 2026 at 9 o'clock, the board shows:
Today is Thursday, 12 November 2026 (week 46)
Winter party:
Saturday, 19 December 2026 (week 51)
37 days and 8 hours to goChange the constants EVENT_NAME and EVENT for your own event. To keep the board up to date, use a timer block with an interval of 1200 ticks (a minute) instead of the button.
How it works
describetakes a TIME. It works for any point in time, not only for now:boardcalls it fornowand forEVENT. Every library function gets the sametime, so all parts belong to the same moment.- Arrays start at 0, the calendar at 1. WEEKDAY and MONTH start at 1, so both arrays start with an empty entry and
weekdays[weekday]needs no calculation. An index can only be a number or a variable, not an expression likeweekday - 1. - Subtracting times.
to - fromis an INTEGER in milliseconds. DIV divides without decimals: the whole days, and of the rest (\is the remainder), the whole hours./would give a FLOAT. - Weeks are ISO weeks. Week 1 is the week with the first Thursday of the year, and weeks start on Monday. So 1 January 2027, a Friday, still belongs to week 53 of 2026 – while YEAR says 2027.
- The time zone counts.
EVENTis 18:00 UTC, which is 19:00 in Berlin. Near midnight, DAY and WEEKDAY of the same TIME can differ from server to server.
Try it yourself
- After the party has started, the board counts negative days. Show "It has started!" instead.
Solution
PROGRAM calendar
NOOP
INCLUDE c0de/time
INCLUDE c0de/math
CONSTANT EVENT_NAME STRING "Winter party"
CONSTANT EVENT TIME @2026-12-19T18:00:00Z
VARIABLE weekdays ARRAY STRING
BEGIN
"" "Monday" "Tuesday" "Wednesday" "Thursday" "Friday" "Saturday" "Sunday"
END VARIABLE
VARIABLE months ARRAY STRING
BEGIN
"" "January" "February" "March" "April" "May" "June"
"July" "August" "September" "October" "November" "December"
END VARIABLE
NOOP
FUNCTION describe
PARAMETER time TIME
RESULT text STRING
BEGIN
VARIABLE weekday INTEGER
VARIABLE day INTEGER
VARIABLE month INTEGER
VARIABLE year INTEGER
VARIABLE week INTEGER
CALL c0de/time/WEEKDAY
PARAMETER time time ;
RESULT result weekday
CALL c0de/time/DAY
PARAMETER time time ;
RESULT result day
CALL c0de/time/MONTH
PARAMETER time time ;
RESULT result month
CALL c0de/time/YEAR
PARAMETER time time ;
RESULT result year
CALL c0de/time/WEEK
PARAMETER time time ;
RESULT result week
ASSIGN text weekdays[weekday] ⊕ ", " ⊕ day ⊕ " " ⊕ months[month] ⊕ " " ⊕ year ⊕ " (week " ⊕ week ⊕ ")" ;
END FUNCTION
NOOP
FUNCTION countdown
PARAMETER from TIME
PARAMETER to TIME
RESULT days INTEGER
RESULT hours INTEGER
BEGIN
CALL c0de/math/DIV
PARAMETER dividend to - from ;
PARAMETER divisor 86400000 ;
RESULT result days
CALL c0de/math/DIV
PARAMETER dividend (to - from) \ 86400000 ;
PARAMETER divisor 3600000 ;
RESULT result hours
END FUNCTION
NOOP
FUNCTION board
BEGIN
VARIABLE now TIME
VARIABLE text STRING
VARIABLE days INTEGER
VARIABLE hours INTEGER
CALL c0de/time/NOW
RESULT result now
CALL describe
PARAMETER time now ;
RESULT text text
CALL CLS
CALL PRINT
PARAMETER value "Today is " ⊕ text ;
CALL describe
PARAMETER time EVENT ;
RESULT text text
CALL PRINT
PARAMETER value EVENT_NAME ⊕ ":" ;
CALL PRINT
PARAMETER value text ;
IF EVENT ≤ now ;
BEGIN
CALL PRINT
PARAMETER value "It has started!" ;
RETURN
END IF
CALL countdown
PARAMETER from now ;
PARAMETER to EVENT ;
RESULT days days
RESULT hours hours
CALL PRINT
PARAMETER value days ⊕ " days and " ⊕ hours ⊕ " hours to go" ;
END FUNCTIONTIME values can be compared like numbers. RETURN ends board early, so the countdown isn't printed.
- Which week does
describereport for 31 December 2024, a Tuesday? Try it: rundescribewith the program runner, or put a TIME variable itemtimewith that date into a trigger block set todescribe. It needs no uninitialized item: the resulttexttakes the place of the parameter item.
Solution
Tuesday, 31 December 2024 (week 1). The week from Monday 30 December 2024 to Sunday 5 January 2025 contains the first Thursday of 2025, so it is week 1 of 2025. Show the year of the week with care: around New Year, it isn't always YEAR.
Read more
- Handbook c0de/time and DIV
- Libraries: c0de/time
- TYPE_TIME and TYPE_ARRAY
- Display block and Timer block