From 3e728a0841d5deba5afc49ff3ab5d84f4609f35a Mon Sep 17 00:00:00 2001 From: Allen Porter Date: Sun, 1 Jan 2023 21:11:34 -0800 Subject: [PATCH] Revert "Update timezone requirements for calendar events (#1601)" (#1604) This reverts commit 1b8d71e9b12d998a02261b84d1045d98207be32c. --- docs/core/entity/calendar.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/docs/core/entity/calendar.md b/docs/core/entity/calendar.md index 74be511c..59654a71 100644 --- a/docs/core/entity/calendar.md +++ b/docs/core/entity/calendar.md @@ -48,9 +48,6 @@ A calendar entity can return events that occur during a particular time range. S - The `end_date` is the upper bound and applied to the event's `start` (exclusive). - Recurring events should be flattened and returned as individual `CalendarEvent`. -The start and end datetime will always have a timezone, which the implementation should be use for -determing the order of events e.g. the start of an all day event for comparison with other events. - ```python class MyCalendar(CalendarEntity): @@ -125,8 +122,8 @@ A `CalendarEvent` represents an individual event on a calendar. | Name | Type | Default | Description | | ----------- | ---------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- | -| start | datetime or date | **Required** | The start (inclusive) of the event. Must be before `end`. Both `start` and `end` must be the same type. As a datetime, may have a timezone or be floating (which is interpreted as local timezone) | -| end | datetime or date | **Required** | The end (exclusive) of the event. Must be after `start`. | +| start | datetime or date | **Required** | The start (inclusive) of the event. Must be before `end`. Both `start` and `end` must be the same type. As a datetime, must be in UTC timezone. | +| end | datetime or date | **Required** | The end (exclusive) of the event. Must be after `start`. As a datetime, must be in UTC timezone. | | summary | string | **Required** | A title or summary of the event. | | location | string | `None` | A geographic location of the event. | | description | string | `None` | A detailed description of the event. |