Set or Get UTC Job Time
job.utc(ujn, utc)
utc = job.utc(jn)
job.utc(ujn, 0) Clears a job
ujn = job.utc(utc, func)
| Parameter | Type | Description |
|---|---|---|
ujn |
integer | UTC Job Number 1-32 |
utc |
integer | UTC time to fire. |
func |
function | Ephemeral function to call |
| Returns | Type | Description |
|---|---|---|
utc |
integer | Time the job is scheduled |
ujn |
integer | Job number assigned. nil if no free jobs. |
There are 32 UTC Job Slots.
These are distinct from the 32 scheduled/repeating jobs.
e.g.
function obJobU5(ujn, utc)
-- ujn = 5 in this case
-- utc = the time called
end
job.utc(5, utc.cvt('2025-09-01 16:00'))
If the form of the call is job.utc(utc, func) then an ephemeral slot will be located.
When the ephemeral job is completed, it's slot will be emptied.
e.g.
job.utc(os.time() + 120, MySpecialFunction)
job.utc(os.time() + 120, function() …dostuff… end)