diff options
| author | Ryan Petrello <rpetrell@redhat.com> | 2018-01-29 18:25:30 +0100 |
|---|---|---|
| committer | Ryan Petrello <rpetrell@redhat.com> | 2018-01-29 18:42:31 +0100 |
| commit | 6753f1ca355cdaffd62831ca637c607ccee90ca7 (patch) | |
| tree | f9116a59a74090bd4a19dd5c314b71fd0f69ba6f /docs | |
| parent | Merge pull request #1067 from ryanpetrello/fix-7869 (diff) | |
| download | awx-6753f1ca355cdaffd62831ca637c607ccee90ca7.tar.xz awx-6753f1ca355cdaffd62831ca637c607ccee90ca7.zip | |
adhere to RFC5545 regarding UNTIL timezones
If the "DTSTART" property is specified as a date with UTC time or a date with
local time and time zone reference, then the UNTIL rule part MUST be specified
as a date with UTC time.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/schedules.md | 18 |
1 files changed, 9 insertions, 9 deletions
diff --git a/docs/schedules.md b/docs/schedules.md index be826bf388..f733b37aa7 100644 --- a/docs/schedules.md +++ b/docs/schedules.md @@ -50,7 +50,10 @@ A list of _valid_ zone identifiers (which can vary by system) can be found at: UNTIL and Timezones =================== -RFC5545 specifies that: +`DTSTART` values provided to awx _must_ provide timezone information (they may +not be naive dates). + +Additionally, RFC5545 specifies that: > Furthermore, if the "DTSTART" property is specified as a date with local > time, then the UNTIL rule part MUST also be specified as a date with local @@ -58,20 +61,17 @@ RFC5545 specifies that: > a date with local time and time zone reference, then the UNTIL rule part > MUST be specified as a date with UTC time. -Given this, this RRULE: +Given this, `RRULE` values that specify `UNTIL` datetimes must *always* be in UTC. +Valid: `DTSTART:20180601T120000Z RRULE:FREQ=DAILY;INTERVAL=1;UNTIL=20180606T170000Z` + `DTSTART;TZID=America/New_York:20180601T120000 RRULE:FREQ=DAILY;INTERVAL=1;UNTIL=20180606T170000Z` -...will be interpretted as "Starting on June 1st, 2018 at noon UTC, repeat -daily, ending on June 6th, 2018 at 5PM UTC". - -This RRULE: +Not Valid: + `DTSTART:20180601T120000Z RRULE:FREQ=DAILY;INTERVAL=1;UNTIL=20180606T170000` `DTSTART;TZID=America/New_York:20180601T120000 RRULE:FREQ=DAILY;INTERVAL=1;UNTIL=20180606T170000` -...will be interpretted as "Starting on June 1st, 2018 at noon EDT, repeat -daily, ending on June 6th, 2018 at 5PM EDT". - Previewing Schedules ==================== |