TIME

It is possible to assign commands to 10 calendar dates ( TIME[0] - TIME[9] ). The date/time can be set in the Setup/Peripherals menu, using the internet with the NTP protocol, or by command. With the help of an RTC module, there is no need for an internet connection; the module can keep the current date and time even after a restart or power outage. It supports DS3231, DS1307, and DS1302 chips. The RTC devices can be set in the Setup/Peripherals menu. If the DS3231 is not a counterfeit, it has a maximum drift of 1 minute per year. It has an internal thermometer, which can be assigned to the TEHU command. Its power supply is 3.3V, and the SCL pin can be shared with the SCL pin of the OLED display(s). The DS1302 and DS1307 are less accurate but have non-volatile RAM, which is used by the NVR command. Some of them work with a 3.3V power supply, but if not, they require 5V.

Date, Time

TIME=Y2026M12D24h20m15s00
Sets the date and time if for some reason NTP is not usable.

TIME@
Sends the time to STDOUT.

TIMES:TIME@
Sends the time to STDOUT when the second changes.
TIMEM:TIME@
Sends the time to STDOUT when the minute changes.

Timer

TIME[0]=Y2026M12D24h20m15s30
Sets the time to execute the commands.
s: second
m: minute
h: hour
D: day
M: month
Y: year
If a parameter is not specified, it will default to the current date/time.

TIME[0]=W0111110h20m16
Executes the commands at 20:16 from Monday to Friday.
W: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday.
0: does not execute.
1: executes.

TIME[0]@
Displays the set time.
TIME[0]R@
Displays the remaining time until the command execution.
TIME[0]E@
Displays the elapsed time since the start.

TIME[0]+1m
s: second
m: minute
h: hour
D: day
If the timer is active, adds the specified value to the set time.
If not active, adds the specified value to the current time and starts the timer.
TIME[0]-10s
Subtracts from the set time.

TIME[0]:LED(ON)
Executes the commands when the time reaches the set value.

TIME[0]F
Stops the timer.
TIME[0]FC
Stops the timer and executes the commands.

Sunrise, Sunset

SUNR@
Displays the sunrise time.
SUNS@
Displays the sunset time.

SUNR:LED(OFF)
Executes the command at sunrise.
SUNS:LED(ON)
Executes the command at sunset.

SUNR+30
SUNR-30
Executes the command 30 minutes after/before sunrise.
SUNS+20
SUNS-20
Executes the command 20 minutes after/before sunset.

Months, Days Names

Examples

Alarm Clock
TIME[0]:LED(ON) <!DOCTYPE html> <html> <body> <H1>ALARM CLOCK</H1><br> <input type="number" id="year" placeholder="Year"/> <input type="number" id="month" placeholder="Month"/> <input type="number" id="day" placeholder="Day"/> <input type="number" id="hour" placeholder="Hour"/> <input type="number" id="min" placeholder="Minute"/> <input type="number" id="sec" placeholder="Second"/> <button type="button" onclick="setnow();">Now</button> <br><br> <button type="button" onclick="alarm='TIME=';settime();">Set Clock</button> <button type="button" onclick="alarm='TIME[0]=';settime();">Set Alarm</button> <br> <H2 id="time"></H2> <H2 id="alarm"></H2> <H2 id="rema"></H2> <script type="text/javascript" src="tools.js"></script> <script> startWS(3); var alarm = ""; function onMessage(msg) { msg = msg.split("~"); if (msg[1] === "0") {document.getElementById('time').innerText = msg[0];} if (msg[1] === "1") {document.getElementById('alarm').innerText = msg[0];} if (msg[1] === "2") {document.getElementById('rema').innerText = msg[0];} } var mytime = setInterval(function () { sendWS("STR[0]@=Current Time: %DATE %TIMES~0"); sendWS("STR[0]@=Alarm Time: %TIME[0]Y. %TIME[0]ML %TIME[0]D. %TIME[0]h:%TIME[0]0m:%TIME[0]0s~1"); sendWS("STR[0]@=Remaining: %TIME[0]RYyear %TIME[0]RMmonth %TIME[0]RDday %TIME[0]Rhhour %TIME[0]Rmminute %TIME[0]Rssecond~2"); }, 1000); function setnow() { var d = new Date(); document.getElementById("sec").value = d.getSeconds(); document.getElementById("min").value = d.getMinutes(); document.getElementById("hour").value = d.getHours(); document.getElementById("day").value = d.getDate(); document.getElementById("month").value = d.getMonth() + 1; document.getElementById("year").value = d.getFullYear(); } function settime() { alarm += "Y" + document.getElementById("year").value; alarm += "M" + document.getElementById("month").value; alarm += "D" + document.getElementById("day").value; alarm += "h" + document.getElementById("hour").value; alarm += "m" + document.getElementById("min").value; alarm += "s" + document.getElementById("sec").value; sendWS(alarm); } </script> </body> </html>