hrs3 format | Pluckeye

Pluckeye uses a format dubbed “hrs3” for daily and weekly schedules.

Overview

Hrs3 stands for “Human Readable Small Schedule String”. Hrs3 strings can describe both recurring events and one-time events.

The raison d’etre for hrs3 is to represent working schedules of real people using a limited number of characters while still preserving some measure of readability by humans. That a schedule may be fully described in a sequence of characters makes possible importing schedules into and exporting schedules from various systems that support hrs3. A (future) canonical format allows for easy comparison of schedules.

Hrs3 schedules are used by Pluck’s when rules and Abmindicate.

Schedule creation tool

The users site has a point-and-click tool you can use to find a schedule to describe a specific set of time periods.

Simple examples

1-2
1:00am to 2:00am every day
13-14
1:00pm to 2:00pm every day
1330-1430
1:30pm to 2:30pm every day
MWF10-12
Monday, Wednesday, and Friday, 10am to 12pm

Types of hrs3

daily
e.g. “8-9” means 8am to 9am every day.
weekly
e.g. “MW8-9” means 8am to 9am on Mondays and Wednesdays.
now
e.g. “now+10m” means from now until 10 minutes from now.
raw
e.g. “20201214151324-20201214151325” means from 2020-12-14 15:13:24 to 2020-12-14 15:13:25.

Days of the week

UMTWRFA
sUnday, Monday, Tuesday, Wednesday, thuRsday, Friday, sAturday

Hours

1-2
1am to 2am
0100-0200
1am to 2am
13-14
1pm to 2pm
1300-1301
1:00pm to 1:01pm
13:00-13:01
1:00pm to 1:01pm (only valid in some versions)
5-6&7-9
5am to 6am and 7am to 9am
5-6,7-9
5am to 6am and 7am to 9am

More examples

MWF7-8.TR8-9
Monday, Wednesday, and Friday 7am to 8am, and Tuesday and Thursday 8am to 9am.
1-2&3-4
1:00am to 2:00am and 3:00am to 4:00am every day
1-2,3-4
1:00am to 2:00am and 3:00am to 4:00am every day
830-945
8:30am to 9:45am every day
0830-0945
8:30am to 9:45am every day
0-24
all the time
MWF10-12
Monday, Wednesday, and Friday, 10am to 12pm
M1330-1400
Monday 13:00 to 14:00 (1:30pm to 2:00pm)
MWF0-24
Monday, Wednesday, and Friday, all day
now+2h
Now to 2 hours from now
20150429120000-20150429120001
2015-04-29 12:00:00 to 2015-04-29 12:00:01