日历实体
日历实体是一个代表具有起始日期和/或时间的事件的实体,对自动化有帮助。日历实体是从homeassistant.components.calendar.calendarentity
。
特性
小费
属性应始终仅从内存中返回信息,而不是I/O(例如网络请求)。实施更新()
或者async_update()
获取数据。
姓名 | 类型 | 默认 | 描述 |
---|---|---|---|
事件 | 日历 | NotimplementedError |
当前或下一个即将到来日历 或者没有任何 。 |
状态
持续的 | 描述 |
---|---|
state_on |
日历有一个活动事件。 |
state_off |
日历没有活动事件。 |
方法
获取活动
日历实体可以返回在特定时间范围内发生的事件。实施者的一些注释:
- 这
开始日期
是下限并应用于活动的结尾
(独家的)。 - 这
结束日期
是上限并应用于事件的开始
(独家的)。 - 重复事件应扁平并作为个人返回
日历
。
班级Mycalendar((日历):
异步防守async_get_events((
自己,,,,
哈斯:乡亲,,,,
开始日期:约会时间。约会时间,,,,
结束日期:约会时间。约会时间,,,,
)->列表[[日历这是给予的:
“”“返回日历范围内的日历事件。”“”
日历
一个日历
代表日历上的单独事件。
姓名 | 类型 | 默认 | 描述 |
---|---|---|---|
开始 | 日期或日期 | 必需的 | 活动的开始(包括)。必须以前结尾 。两个都开始 和结尾 必须是相同的类型。作为日期时间,必须在UTC时区中。 |
结尾 | 日期或日期 | 必需的 | 活动的结尾(独家)。必须之后开始 。作为日期时间,必须在UTC时区中。 |
概括 | 细绳 | 必需的 | 活动的标题或摘要。 |
地点 | 细绳 | 没有任何 |
活动的地理位置。 |
描述 | 细绳 | 没有任何 |
事件的详细描述。 |