---
title: "Action check_schedule"
description: "Checks whether the current time is within working hours (including weekends and timezone)."
---

# Action `check_schedule`

> **System ID:** `action_check_schedule`

## Description

Compares the current time with the `morning_time`–`evening_time` window, optionally excludes days in `weekends`, and applies `timezone`. Typically used before connecting to an operator.

Time format: hour number (`9`) or string `"H-M"` (`"9-30"`). Days: `0` = Sunday … `6` = Saturday.

## Events (scenario branches)

| Event | When it occurs |
|-------|----------------|
| **success** | Now within working hours and not a weekend (if configured) |
| **error** | Outside hours, weekend, or time before `morning_time` |

## Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `morning_time` | number / string | no | — | Start of the working day (`9` or `"9-30"`) |
| `evening_time` | number / string | no | — | End of the working day (`18` or `"18-00"`) |
| `weekends` | array | no | — | Exclusion days (`[0, 6]` = Sun, Sat) |
| `timezone` | string | no | `Europe/Kyiv` | Timezone (moment-timezone name) |

## Configuration example

```json
{
  "morning_time": 9,
  "evening_time": 18,
  "weekends": [0, 6],
  "timezone": "Europe/Kyiv"
}
```

## Related docs

- [Actions reference](/en/actionjail/reference/actions-reference.md)