jeans/developers.home-assistant
jeans/developers.home-assistant
1
0
Fork 0
mirror of https://github.com/home-assistant/developers.home-assistant.git synced 2025-06-18 08:06:29 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update timezone requirements for calendar events (#1601)

Browse Source
This commit is contained in:
Allen Porter 2022-12-31 12:23:34 -08:00 committed by GitHub
parent 2d2d29c82f
commit 1b8d71e9b1
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 5 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
docs/core/entity/calendar.md
View File

@ -48,6 +48,9 @@ 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). - 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`. - 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 ```python
class MyCalendar(CalendarEntity): class MyCalendar(CalendarEntity):
@ -122,8 +125,8 @@ A `CalendarEvent` represents an individual event on a calendar.
| Name | Type | Default | Description | | 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, must be in UTC timezone. | | 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`. As a datetime, must be in UTC timezone. | | end | datetime or date | **Required** | The end (exclusive) of the event. Must be after `start`. |
| summary | string | **Required** | A title or summary of the event. | | summary | string | **Required** | A title or summary of the event. |
| location | string | `None` | A geographic location of the event. | | location | string | `None` | A geographic location of the event. |
| description | string | `None` | A detailed description of the event. | | description | string | `None` | A detailed description of the event. |