Roku Object Reference - imaginArt

• SetMillisecond(millisecond As Integer) As Void
• AddSeconds(seconds As Integer) As Void
• SubtractSeconds(seconds As Integer) As Void
• AddMilliseconds(milliseconds As Integer) As Void
• SubtractMilliseconds(milliseconds As Integer) As Void
• Normalize() As Boolean
o Check that all the fields supplied are correct. It fails if values are out of bounds
A newly created object is at the time represented by zero seconds.
When used via the ifString interface ifDateTime will always use the sortable date format "YYYY-MM-DD
hh:mm:ss".
roTimer ()
The roTimer object implements ifTimer and ifSetMessagePort. This ifTimer interface provides:
• SetTime(hour As Integer, minute As Integer, second As Integer,
millisecond As Integer) As Void
• SetDate(year As Integer, month As Integer, day As Integer) As Void
• SetDayOfWeek(day_of_week As Integer) As Void
o Set the time that you wish the event to trigger. In general if a value is -1 then it is a wildcard
and will cause the event to trigger every time the rest of the specification matches. If there are
no wildcards, then the timer will trigger only once, when the specified date/time occurs. It is
possible using a combination of day and day_of_week to specify invalid combinations that
will never occur.
o If specifications include any wildcard then the second and millisecond specification must be
zero. Events will be raised at most once a minute near the whole minute.
• SetDateTime(As ifDateTime) As Void
o Set the time that you wish the event to trigger from a roDateTime object. It is not possible to
set wildcards using this method.
• Start() As Boolean
o Start the timer based on the current values specified via the above functions.
• Stop() As Boolean
o Stop the timer.
Example: This code creates a timer that triggers every 30 seconds.
st=CreateObject("roSystemTime")
timer=CreateObject("roTimer")
mp=CreateObject("roMessagePort")
timer.SetPort(mp)
timeout=st.GetLocalDateTime()
timeout.AddSeconds(30)
timer.SetDateTime(timeout)
timer.Start()
while true
ev = wait(0, mp)
if (type(ev) = "roTimerEvent") then
print "timer event received"
timeout=st.GetLocalDateTime()
36