IsTimeBetween

Returns true when the current clock time falls inside a window. The window is half-open: it includes the start time and excludes the end time. When the end time is earlier than the start time, the window crosses midnight.

Category: Time Returns: bool

Signature

IsTimeBetween(start, end)

Both arguments are clock times written as quoted “HH:MM” text, like ‘22:00’. The validator rejects anything else.

Examples

IsTimeBetween('09:00', '17:00')   // true during business hours
IsTimeBetween('22:00', '06:00')   // true at 23:00 AND at 03:00 (crosses midnight)
!IsTimeBetween('06:00', '22:00')  // the same night window, written inside out

Notes

  • Requires time to be enabled for the project (Project, then Time). With time disabled, any expression using this function fails validation.
  • The half-open window composes cleanly at time-bucket edges: IsTimeBetween(‘06:00’, ‘12:00’) and IsTimeBetween(‘12:00’, ‘17:00’) never overlap and leave no gap at 12:00.
  • When start and end are the same time, the window is empty and the function always returns false. There is no way to write a full-day window; a condition that should hold all day doesn’t need a time check.
  • To react to a window that is about to close, pair with MinutesUntil.
Docs last synced: 2026-07-18
Screenshot viewer