Skip to content

Time Interval

A time interval defines a recurrence pattern for generating time slots.

The configuration combines rules across the dimensions Year → Month → Day → Hour → Minute. A timestamp is generated whenever all configured rules match.

The Duration determines how long each generated occurrence lasts. Each occurrence forms a time slot starting at the generated timestamp.

Generated time slots cannot overlap.

General

The General tab defines the identity of the time interval.

Name

A human-readable identifier for the time interval.

The name is only used for identification in the user interface and does not affect the recurrence pattern.

Names do not need to be unique.

Description

An optional description explaining the purpose of the interval.

This field exists only to help administrators understand the configuration and has no effect on system behavior.

Minute

The Minute tab defines which minutes within an hour generated timestamps may start.

Only one rule can be active at a time.

The selected rule determines the set of valid minutes within each hour.

Each minute

Generates an occurrence for every minute within the hour.

Generated minutes:

00
01
02
...
59

Example generated timestamps (hour = 08):

08:00
08:01
08:02
...
08:59

This produces 60 occurrences per hour when the duration allows it.

Stepped repetition

Generates occurrences at a fixed interval starting from a specified minute.

Example configuration:

every 5 minutes starting at minute 30

Generated minutes:

30
35
40
45
50
55

Example generated timestamps (hour = 08):

08:30
08:35
08:40
08:45
08:50
08:55

The sequence stops at the end of the hour.

Selected minutes

Allows selecting specific minutes within the hour.

Example selection:

03
25
39

Generated timestamps (hour = 08):

08:03
08:25
08:39

Important behavior:

  • selected minutes are stored exactly as chosen
  • the preview always displays occurrences in chronological order

Between

Generates occurrences for every minute within an inclusive range.

Example configuration:

every minute between minute 13 and 39

Generated minutes:

13
14
15
...
39

Example generated timestamps (hour = 08):

08:13
08:14
08:15
...
08:39

Hour

The Hour tab defines which hours within a day generated timestamps may start.

Only one rule can be active at a time.

The minute used for those timestamps is defined in the Minute tab.

Each hour

Generates an occurrence for every hour of the day.

Example (minute = 00):

00:00
01:00
02:00
...
23:00

This produces 24 occurrences per day when the duration allows it.

Stepped repetition

Generates occurrences at a fixed interval starting from a specified hour.

Example configuration:

every 2 hours starting at hour 05

Generated hours:

05
07
09
11
13
15
17
19
21
23

Example generated timestamps (minute = 00):

05:00
07:00
09:00
11:00
13:00
15:00
17:00
19:00
21:00
23:00

The sequence stops at the end of the day.

Selected hours

Allows selecting specific hours within the day.

Example selection:

02
21

Generated timestamps (minute = 00):

02:00
21:00

Important behavior:

  • selected hours are stored exactly as chosen
  • the preview displays occurrences in chronological order

Between

Generates occurrences for every hour within a specified range.

Example configuration:

every hour between hour 7 and 5

Generated hours:

07
08
09
...
23
00
01
02
03
04
05

Example generated timestamps (minute = 00):

07:00
08:00
09:00
...
23:00
00:00
01:00
...
05:00

Range behavior:

  • both boundary values are included
  • if the start hour is greater than the end hour, the range continues past midnight

Day

The Day tab defines which calendar days generated timestamps may occur on.

This layer determines which days are eligible, while the Hour and Minute settings determine the exact time.

Each day of week

Generates an occurrence on every day.

Example generated timestamps (hour = 00, minute = 00):

2026-03-14 00:00
2026-03-15 00:00
2026-03-16 00:00
2026-03-17 00:00
...

Every X days starting from weekday

Generates occurrences every N days, beginning from a specific weekday.

Example configuration:

every 3 days starting Monday

Example generated timestamps:

2026-03-16 00:00
2026-03-19 00:00
2026-03-23 00:00
2026-03-26 00:00
2026-03-30 00:00
...

The interval continues across weeks and months without resetting.

Every X days starting from month day

Generates occurrences every N days, starting from a specific calendar day of the month.

Example configuration:

every 7 days starting on the 5th

Example generated timestamps:

2026-03-05 00:00
2026-03-12 00:00
2026-03-19 00:00
2026-03-26 00:00
2026-04-02 00:00
...

Selected weekdays

Allows selecting specific weekdays.

Example selection:

Monday
Wednesday

Generated timestamps:

2026-03-16 00:00
2026-03-18 00:00
2026-03-23 00:00
2026-03-25 00:00
...

Selected days of month

Generates occurrences on specific calendar days within each month.

Example selection:

5
17
18

Generated timestamps:

2026-03-05 00:00
2026-03-17 00:00
2026-03-18 00:00
2026-04-05 00:00
2026-04-17 00:00
2026-04-18 00:00
...

Last day of month

Generates an occurrence on the final calendar day of each month.

Example generated timestamps:

2026-03-31 00:00
2026-04-30 00:00
2026-05-31 00:00
2026-06-30 00:00
...

Last weekday of month

Generates an occurrence on the last weekday (Monday–Friday) of each month.

If the final day falls on a weekend, the occurrence moves to the closest preceding weekday.

Example generated timestamps:

2026-03-31 00:00
2026-04-30 00:00
2026-05-29 00:00
2026-06-30 00:00
...

Last named weekday in month

Generates an occurrence on the last occurrence of a specific weekday within each month.

Example:

last Tuesday of the month

Generated timestamps:

2026-03-31 00:00
2026-04-28 00:00
2026-05-26 00:00
2026-06-30 00:00
...

Last X days from end of month

Generates an occurrence a fixed number of days before the end of the month.

Example configuration:

10 days before end of month

Generated timestamps:

2026-03-21 00:00
2026-04-20 00:00
2026-05-21 00:00
2026-06-20 00:00
...

Nearest weekday to day of month

Generates an occurrence on the weekday closest to a selected calendar day.

Example configuration:

nearest weekday to the 9th

Example generated timestamps:

2026-04-09 00:00
2026-05-08 00:00
2026-06-09 00:00
2026-07-09 00:00
...

Nth weekday of month

Generates an occurrence on the Nth occurrence of a weekday within a month.

Example configuration:

fifth Monday of the month

Generated timestamps:

2026-03-30 00:00
2026-06-29 00:00
2026-08-31 00:00
2026-11-30 00:00
...

If a month does not contain that occurrence, no timestamp is generated for that month.

Month

The Month tab defines which months generated timestamps may occur in.

This layer determines which months are eligible, while the Day, Hour, and Minute settings determine the exact date and time.

Each month

Generates occurrences in every month of the year.

Example generated timestamps (day = 14, hour = 00, minute = 00):

2026-03-14 00:00
2026-04-14 00:00
2026-05-14 00:00
2026-06-14 00:00
...

Every X months starting from month

Generates occurrences every N months, starting from a specific month.

Example configuration:

every 3 months starting in February

Generated timestamps:

2026-02-14 00:00
2026-05-14 00:00
2026-08-14 00:00
2026-11-14 00:00
2027-02-14 00:00
...

The selected month acts as the anchor for the interval.

Selected months

Allows selecting specific months of the year.

Example selection:

January
April
July
October

Generated timestamps:

2026-01-14 00:00
2026-04-14 00:00
2026-07-14 00:00
2026-10-14 00:00
2027-01-14 00:00
...

The pattern repeats every year.

Between

Generates occurrences within a continuous range of months.

Example configuration:

between March and September

Generated timestamps:

2026-03-14 00:00
2026-04-14 00:00
2026-05-14 00:00
2026-06-14 00:00
2026-07-14 00:00
2026-08-14 00:00
2026-09-14 00:00
2027-03-14 00:00
...

Both boundary months are included.

Year

The Year tab defines which years generated timestamps may occur in.

This layer determines which years are eligible, while the Month, Day, Hour, and Minute settings determine the exact time within those years.

Each year

Generates occurrences in every year.

Example generated timestamps (month = March, day = 14, hour = 00, minute = 00):

2026-03-14 00:00
2027-03-14 00:00
2028-03-14 00:00
2029-03-14 00:00
...

Every X years starting from year

Generates occurrences every N years, beginning from a specific year.

Example configuration:

every 2 years starting in 2026

Generated timestamps:

2026-03-14 00:00
2028-03-14 00:00
2030-03-14 00:00
2032-03-14 00:00
...

The selected year acts as the anchor for the interval.

Selected years

Allows selecting specific years.

Example selection:

2026
2028
2030

Generated timestamps:

2026-03-14 00:00
2028-03-14 00:00
2030-03-14 00:00

Only the selected years generate occurrences.

Between

Generates occurrences within a continuous range of years.

Example configuration:

between 2026 and 2030

Generated timestamps:

2026-03-14 00:00
2027-03-14 00:00
2028-03-14 00:00
2029-03-14 00:00
2030-03-14 00:00

Both boundary years are included.

Duration

The Duration defines how long each generated occurrence lasts.

While the recurrence rules determine when an occurrence starts, the duration determines when it ends.

The same duration is applied to every generated timestamp.

Durations may include minutes, hours, days, months, or years, and multiple units can be combined.

Single unit duration

A duration can be defined using a single time unit.

Example configuration:

duration: 1 minute

Generated intervals:

2026-03-14 00:00 → 2026-03-14 00:01
2026-03-15 00:00 → 2026-03-15 00:01
2026-03-16 00:00 → 2026-03-16 00:01
...

Hour duration

Example configuration:

duration: 1 hour

Generated intervals:

2026-03-14 08:00 → 2026-03-14 09:00
2026-03-14 09:00 → 2026-03-14 10:00
2026-03-14 10:00 → 2026-03-14 11:00
...

Day duration

Example configuration:

duration: 2 days

Generated intervals:

2026-03-14 00:00 → 2026-03-16 00:00
2026-03-16 00:00 → 2026-03-18 00:00
...

Combined duration units

Multiple units can be combined.

Example configuration:

duration: 1 month and 3 days

Generated intervals:

2026-03-14 00:00 → 2026-04-17 00:00
2026-04-14 00:00 → 2026-05-17 00:00
...

Key behavior

  • the duration always begins at the generated start timestamp
  • the same duration is applied to every occurrence
  • duration does not affect how often occurrences are generated
  • duration determines how long each occurrence remains active
  • generated time slots cannot overlap

Understand the concept