行事曆時區、全天事件與提醒

timezone 必須是有效 IANA timezone，例如 Asia/Taipei。timed 事件的 startAt、endAt 使用 UTC 或含 offset 的 ISO datetime，且 endAt 必須晚於 startAt。timezone 決定 recurring wall-clock 展開與 all-day 換算，不可改用猜測的固定 offset。

allDay 預設 false。allDay: true 必須提供 YYYY-MM-DD 的 date 與 timezone；runtime 會把當地 00:00 到翌日 00:00 轉成 UTC 區間。timed 轉 all-day 需要 date + timezone；all-day 轉 timed 需要 startAt + endAt。list 範圍必須正向且最多 180 天，更大範圍應拆開查。

reminders 只允許 0、5、15、30、60、1440 分鐘，0 代表事件開始時；all-day 事件只保留 1440，代表提前一天。通知會送給行事曆 owner 與 members，但只是事件通知；若使用者要時間到喚醒 Agent 或執行工作，應使用 Cron。recurring reminders 由 runtime 預先產生，不承諾精確的生成或送達時效。

Related actions

arinova.calendar.list_events, arinova.calendar.create_event, arinova.calendar.update_event

Also known as

行事曆時區, 全天事件, 整天活動, 事件提醒, IANA timezone, reminder minutes, 180 天範圍

---

Machine-readable Markdown · Knowledge index