> ## Documentation Index
> Fetch the complete documentation index at: https://docs.safesquid.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Time Profiler

<Note>
  CLI man page: `safesquid-timeProfiles(5)`
</Note>

The **Time Profiler** section (`safesquid-timeProfiles(5)`) tags connections with time labels from the appliance local clock. [Access Profiles](/admin_guide/policies_and_profiles/access_profiles) **Time Schedule** matches these tags.

## Core mechanics

### Row gate order

1. **Time Profiles** prerequisite tags (`profile_find`).
2. **Weekday range** — always enforced (Sunday = 0 … Saturday = 6).
3. **Match mode** — ABSOLUTE timestamp window or ALL RANGES (month + day + minutes-from-midnight).
4. Add/remove time labels.

<Frame caption="Time Profiler — match flow">
  <img src="https://mintcdn.com/safe-squid-labs-12a0916f/VRx-_vpMam8ezhZz/images/admin_guide/time_profiler_flowchart.svg?fit=max&auto=format&n=VRx-_vpMam8ezhZz&q=85&s=e3769b635131617c0cc28cfe2a8f6df4" alt="Time Profiler match flow" width="480" height="320" data-path="images/admin_guide/time_profiler_flowchart.svg" />
</Frame>

<Warning>
  **Weekday active flag** is stored but not checked — weekday bounds always apply. Set explicit 0–6 or 1–5 ranges; template default 0 alone matches Sunday only.
</Warning>

### Match modes

* **ABSOLUTE** — Single start/end timestamp from configured month, day, hour, minute fields.
* **ALL RANGES** — Current month, day-of-month, and time-of-day must each fall in inclusive windows.

## Examples

<Tip>
  ### Business hours

  **Config:** Weekday Mon–Fri, hours 9–17, ALL RANGES, add `business-hours`.

  **Result:** tag present weekdays 09:00–17:59 local time.
</Tip>

<Tip>
  ### Lunch window

  **Config:** Weekday 1–5, hours 12–13, add `LUNCH_TIME`.

  **Result:** Access Profiles can Allow/Deny based on lunch tag.
</Tip>

## How to verify

1. Test inside and outside window with **Trace Entry**.
2. Detailed logs `time_profiles` column.
3. Confirm appliance timezone and clock.


## Related topics

- [Time Profiles](/use_cases/profiling_engine/time_profiles.md)
- [Allow Social Networking Sites During Lunch Hours](/use_cases/access_restriction/allow_social_networking_sites_during_lunch_hours.md)
- [Access Profiles](/admin_guide/policies_and_profiles/access_profiles.md)
- [Authentication](/admin_guide/start_here/authentication.md)
- [Architecture and request pipeline](/admin_guide/start_here/architecture.md)