---
{
  "id": "platform.calendar.timezones-allday-and-reminders",
  "topic": "calendar",
  "title": "行事曆時區、全天事件與提醒",
  "locale": "zh-TW",
  "version": "2026-08-25",
  "summary": "Calendar 使用 IANA 時區與 ISO datetime，把全天日期換成 UTC 區間，並送出限定分鐘數的事件通知。",
  "content": "timezone 必須是有效 IANA timezone，例如 `Asia/Taipei`。timed 事件的 `startAt`、`endAt` 使用 UTC 或含 offset 的 ISO datetime，且 `endAt` 必須晚於 `startAt`。timezone 決定 recurring wall-clock 展開與 all-day 換算，不可改用猜測的固定 offset。\n\n`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 天，更大範圍應拆開查。\n\nreminders 只允許 0、5、15、30、60、1440 分鐘，0 代表事件開始時；all-day 事件只保留 1440，代表提前一天。通知會送給行事曆 owner 與 members，但只是事件通知；若使用者要時間到喚醒 Agent 或執行工作，應使用 Cron。recurring reminders 由 runtime 預先產生，不承諾精確的生成或送達時效。\n",
  "aliases": [
    "行事曆時區",
    "全天事件",
    "整天活動",
    "事件提醒",
    "IANA timezone",
    "reminder minutes",
    "180 天範圍"
  ],
  "tags": [
    "calendar",
    "timezone",
    "reminders"
  ],
  "relatedActions": [
    "arinova.calendar.list_events",
    "arinova.calendar.create_event",
    "arinova.calendar.update_event"
  ],
  "relatedActionPrefixes": [],
  "url": "https://docs.arinova.ai/zh-tw/kb/calendar/timezones-allday-and-reminders/"
}
---

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 預先產生，不承諾精確的生成或送達時效。