← 返回日历日程组件参考 · 全部使用指导

日历日程使用指导

• 日历日程使用指导
  • 快速上手：把会议加入日历
  • 列出未来 7 天的日程
  • 搭建与测试
  • 属性、方法与事件速查
  • 常见问题与验收
  • 完整 .aia 源码与操作指导
    • 日历日程

不可见组件：往手机的系统日历里添加日程（可以设提前几分钟提醒，到时由系统日历弹提醒，App 关着也照样提醒）、 查询某段时间的日程、删除日程；或者打开系统日历的新建日程界面，预先填好内容，由用户自己确认保存。

添加、查询、删除的结果都通过事件返回（先调用方法，再在对应事件里拿结果）。 第一次添加或查询时会向用户申请日历权限；只用「打开新建日程界面」不需要任何权限，应用也不会声明日历权限。

快速上手：把会议加入日历

各案例独立使用；组合到同一屏幕时，将同名事件的处理合并到一个事件积木中。

when 按钮_加入.Click() {
  日历日程1.AddEvent("组会", 计时器1.MakeInstantFromParts(2026, 10, 8, 9, 0, 0), 计时器1.MakeInstantFromParts(2026, 10, 8, 10, 0, 0), "305 室", "带电脑", 15)
}

when 日历日程1.EventAdded(日程编号) {
  微数据库1.StoreValue("meeting_id", 日程编号)
  对话框1.ShowAlert("已加入日历，开会前 15 分钟提醒")
}

when 按钮_取消.Click() {
  日历日程1.DeleteEvent(微数据库1.GetValue("meeting_id", 0))
}

添加成功后拿到的日程编号要存起来（上面存进了微数据库），以后删除这条日程时要用。

列出未来 7 天的日程

查询结果是一个列表，每一项是一个字典，键有 id、title、start、end、location、description、allDay， 其中 start、end 是毫秒数，用计时器的「由毫秒建时间点」转成时间点再格式化：

when 按钮_查询.Click() {
  日历日程1.GetEvents(计时器1.Now(), 计时器1.AddDays(计时器1.Now(), 7))
}

when 日历日程1.GotEvents(日程列表) {
  var lines = []
  foreach ev in 日程列表 {
    listAdd(lines, join(计时器1.FormatDateTime(计时器1.MakeInstantFromMillis(dictGet(ev, "start", 0)), "MM-dd HH:mm"), "  ", dictGet(ev, "title", "")))
  }
  列表显示框1.Elements = lines
}

不想申请权限？用「打开新建日程界面」，用户在系统日历里看一眼再点保存：

when 按钮_提醒我.Click() {
  日历日程1.OpenEventEditor("交电费", 计时器1.AddDays(计时器1.Now(), 3), 计时器1.AddHours(计时器1.AddDays(计时器1.Now(), 3), 1), "", "支付宝缴费")
}

搭建与测试

在设计器拖入本组件和案例涉及的按钮、标签、布局等组件，按案例中的名称重命名。先运行最小案例，确认事件返回，再增加业务逻辑。示例中的素材先上传到项目，服务器地址、令牌、文件路径换成自己的值。

可见组件需要有非零宽高；不可见工具组件必须由属性或方法启动。设计器展示样式不等于运行时已加载数据或绑定目标。联机测试应使用包含本组件的 AI 伴侣；涉及系统入口或权限的行为还要编译安装后验证。

属性、方法与事件速查

完整参数类型、默认值和平台说明见组件参考。下表按调用入口列出用途；有完成事件的方法在事件中读取结果。

常见问题与验收

完整 .aia 源码与操作指导

下载 .aia 源码

操作真实系统日历，需要允许读写日历权限。时间由本机当前时间计算：1小时后开始、持续30分钟、提前10分钟提醒。独立安装或伴侣均操作系统日历；测试完删除直接添加的演示日程。

导入 CalendarEventsAllFeatures.aia，连接最新伴侣，或编译独立安装包。真机／伴侣运行尚未实测。

所有返回值均用于界面反馈，错误由底部错误区展示。设计器采用明确非默认配置，初始化与界面同步。API 覆盖检查按最终 AIA 检查方法、事件、属性读取与设置及设计器配置，不能替代真实设备验证。

日历日程

导入方法：项目 → 导入项目（.aia）→ 选择下载的 .aia 源码文件。 操作真实系统日历，需要允许读写日历权限。时间由本机当前时间计算：1小时后开始、持续30分钟、提前10分钟提醒。独立安装或伴侣均操作系统日历；测试完删除直接添加的演示日程。 覆盖检查 7/7。首次载入及保存重开均0个错误，真实后台导入、安装包编译通过；真机／伴侣／硬件联调尚未实测。全部属性读写、方法与事件的操作入口和预期结果见组件指导。