time:addSecs - Core4 Lua Commands

SYNOPSIS

time:addSecs(n)
time:addMSecs(n)

DESCRIPTION

Adds the specified number of seconds or milliseconds, respectively, to the value stored in time.

By adding time, the hours value of a time object can go beyond 23, to allow it's use for measuring larger time intervals.

You can subtract time by using negative values. If the resulting time after subtraction is negative, the time object becomes invalid.

ERRORS

Raises an error if time is not a time instance.

EXAMPLE

> > >

t = clock.newTime(10, 0, 0) t:addSecs(300) print(t)

10:05:00

SEE ALSO

clock.currentTime, clock.newTime, time(), time:format, time:hour, time:isNull, time:isValid, time:millisecondsFromMidnight, time:minute, time:minutesFromMidnight, time:msec, time:msecsTo, time:second, time:secondsFromMidnight, time:secsTo, time:set, tostring(time)