CurrentHour

Returns the current hour of the in-fiction clock, 0 through 23. This is a clock-of-day reading: it resets at midnight and never exceeds 23, unlike the elapsed counters (AbsoluteMinutes, Day).

Category: Time Returns: int

Signature

CurrentHour()

No arguments.

Examples

CurrentHour() < 6                       // still the small hours
CurrentHour() >= 18                     // evening onward
CurrentHour() == 12 && CurrentMinute() == 0
                                         // exactly noon

Notes

  • Requires time to be enabled for the project (Project, then Time). With time disabled, any expression using this function fails validation.
  • Pairs with CurrentMinute for a minute-level read. For a single window comparison, IsTimeBetween reads more directly than combining the two clock parts by hand.
  • For “how much time has passed” rather than “what time is it”, use AbsoluteMinutes: CurrentHour() wraps every day, AbsoluteMinutes() never does.
Docs last synced: 2026-07-18
Screenshot viewer