Rally Schedule Utilities

Pure utility functions for rally loop scheduling and time calculations. Provides minute-boundary rounding, slot size conversion, and time comparison helpers.

Public API

Internals

roundToNextMinute

math.ceil(timeSecs / 60) * 60

Always rounds up. E.g., 61 → 120, 60 → 60, 59 → 60.

calculateNextSlotTime

Combines slot addition with optional minute rounding:

local newTime = currentTime + (slotSizeMinutes * 60)
if roundToMinute then
  newTime = roundToNextMinute(newTime)
end

Default: slotSizeMinutes = 1, roundToMinute = true.

isLaterTime

Simple comparison with optional tolerance buffer:

return newTime > (currentTime + tolerance)

How It Works

These are stateless helper functions used by rallyLoopManager for schedule calculation:

• Rounding TC and SS start times to minute boundaries
• Computing next available time slots
• Checking whether rescheduled times are actually later than originals

Usage Example

local ScheduleUtils = require('gameplay/rally/loop/scheduleUtils')

-- Round to next minute
local nextMin = ScheduleUtils.roundToNextMinute(125)  -- 180

-- Calculate next 2-minute slot
local nextSlot = ScheduleUtils.calculateNextSlotTime(100, 2)  -- 240 (rounded)

-- Check if rescheduled time is actually later
if ScheduleUtils.isLaterTime(newTime, oldTime, 5) then
  -- apply reschedule
end

See Also

• Rally Loop Penalties - Related reference
• Rally Attempts - Related reference
• Rally Event Log - Related reference
• Gameplay Systems Guide - Guide