快应用 日历事件
接口声明
{"name": "system.calendar"}
导入模块
import calendar from '@system.calendar'
或
const barcode = require('@system.calendar')
接口定义
calendar.insert(OBJECT)
插入日历事件
权限要求
访问日历
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| title | String | 是 | 事件的标题 |
| description | String | 否 | 事件的描述 |
| startDate | long | 是 | 事件开始时间，以从公元纪年开始计算的协调世界时毫秒数表示 |
| endDate | long | 是 | 事件结束时间，以从公元纪年开始计算的协调世界时毫秒数表示 |
| timezone | String | 否 | 事件的时区 |
| allDay | boolean | 否 | true 表示此事件占用一整天（按照本地时区的定义）。 false 表示它是常规事件，可在一天内的任何时间开始和结束 |
| rrule | String | 重复事件必须 | 事件的重复发生规则格式。例如，"FREQ=WEEKLY;COUNT=10;WKST=SU"。 您可以在此处找到更多示例 |
| remindMinutes | Array | 否 | 在事件开始前几分钟进行提醒。例如：[5,15,30] |
| organizer | String | 否 | 事件组织者（所有者）的电子邮件 |
| success | Function | 否 | 成功回调，值为插入成功的id |
| fail | Function | 否 | 失败回调 |
| cancel | Function | 否 | 取消回调 |
fail返回错误代码
| 错误码 | 说明 |
|---|---|
| 201 | 用户拒绝，获取写日历权限失败 |
202 1000+ |
参数非法，如输入时间格式不对、参数不符合标准 |
示例：
calendar.insert({
title: '事件Ａ',
startDate: '1490770543000',
endDate: '1490880543000',
remindMinutes: [5, 15, 30],
duration: 'PT1H',
rrule: 'FREQ=WEEKLY;COUNT=２',
success: function (data) {
console.log('handling success')
}
})
后台运行限制
禁止使用。
后台运行详细用法参见 后台运行脚本。