Skip to content

Schedule format reference

Syntax

[time-range] [day-spec] [timezone?]

The time range must precede the day specification. Both are required unless using a named preset. The timezone suffix is optional — see Timezone resolution.

Time range

Hour precision

H-H

Single or double-digit hours in 24-hour format.

ExampleStartEnd
9-179:00 AM5:00 PM
0-23Midnight11:00 PM
8-188:00 AM6:00 PM

Minute precision

HHMM-HHMM

Zero-padded 4-digit times.

ExampleStartEnd
0800-17308:00 AM5:30 PM
0900-17009:00 AM5:00 PM
0630-22006:30 AM10:00 PM

Day specification

ValueDays
monMonday only
tueTuesday only
wedWednesday only
thuThursday only
friFriday only
satSaturday only
sunSunday only
mon-friMonday through Friday
weekdaysMonday through Friday (alias)
sat-sunSaturday and Sunday
weekendsSaturday and Sunday (alias)
mon-sunAll days
dailyAll days (alias)

Day ranges use the order Monday → Sunday. wed-fri is valid; fri-wed is not.

Named presets

ValueEquivalentDescription
weekdays-business-hours9-17 mon-friMon–Fri, 9 AM–5 PM
always-onNo schedule, always running
always-offNo schedule, always stopped

Timezone resolution

Times are interpreted using the first timezone that resolves in this order:

PrioritySourceExample
1Explicit suffix on the tag9-17 mon-fri CET
2Resource’s AWS regioneu-west-3Europe/Paris
3Stack Timezone CloudFormation parameterEurope/London
4UTCfallback

Timezone suffix

Append a timezone abbreviation (case-insensitive) after the day specification:

9-17 mon-fri CET
0830-1730 mon-fri BST
8-18 weekdays EST

Supported abbreviations: UTC, GMT, BST, CET, CEST, EET, EEST, EST, EDT, CST, CDT, MST, MDT, PST, PDT, IST, JST, AEST, AEDT, ACST, ACDT, AWST.

Region defaults

If no suffix is given, the resource’s own AWS region determines the timezone. Resources in different regions each get the correct local time automatically, even within the same account.

AWS RegionDefault timezone
us-east-1America/New_York
us-east-2America/New_York
us-west-1America/Los_Angeles
us-west-2America/Los_Angeles
eu-west-1Europe/Dublin
eu-west-2Europe/London
eu-west-3Europe/Paris
eu-central-1Europe/Berlin
eu-north-1Europe/Stockholm
ap-southeast-1Asia/Singapore
ap-southeast-2Australia/Sydney
ap-northeast-1Asia/Tokyo
ap-south-1Asia/Kolkata

Examples

9-17 mon-fri Monday–Friday, 9 AM–5 PM (resource region timezone)
8-18 weekdays Monday–Friday, 8 AM–6 PM (resource region timezone)
0800-1730 mon-fri Monday–Friday, 8:00 AM–5:30 PM (resource region timezone)
9-17 mon-fri CET Monday–Friday, 9 AM–5 PM Central European Time
0830-1730 mon-fri BST Monday–Friday, 8:30 AM–5:30 PM British Summer Time
8-18 weekdays EST Monday–Friday, 8 AM–6 PM Eastern Standard Time
10-16 weekends Saturday–Sunday, 10 AM–4 PM (resource region timezone)
weekdays-business-hours Monday–Friday, 9 AM–5 PM (resource region timezone)

Validation rules

  • Time must come before days (9-17 mon-fri ✓, mon-fri 9-17 ✗)
  • Hours must be 0–23
  • Minutes must be 0–59
  • End time must be after start time
  • Day ranges must follow Monday → Sunday order

If the schedule tag value is invalid, the resource will still appear in the dashboard with a parse error notice. No EventBridge rules will be created until the value is corrected.