目录

qa.addPhoneRepeatCalendar(1106+)

接口描述

向系统日历添加重复事件。

使用限制

限制条件

说明

适用终端

手机、平板

适用区域

中国

接口定义

[h2]qa.addPhoneRepeatCalendar(Object object)

描述

向系统日历添加重复事件。

OBJECT参数

参数

类型

是否必填

描述

title

string

是

日历事件标题。

startTime

number

是

开始时间的 unix 时间戳(1970年1月1日开始所经过的秒数)。

allDay

boolean

否

是否全天事件,默认为false。

description

string

否

事件说明。

location

string

否

事件位置。

endTime

string

否

结束时间的 unix 时间戳,默认与开始时间相同。

alarm

boolean

否

是否提醒,默认为true。

alarmOffset

number

否

提醒提前量,单位秒。

默认值为0,表示开始时提醒。

repeatInterval

string

否

重复周期。取值如下:

  • day:每天重复。
  • week:每周重复。
  • month(默认):每月重复(该模式日期不能大于 28 日)。
  • year:每年重复。

repeatEndTime

number

否

重复周期结束时间的 unix 时间戳,不填表示一直重复。

success

function

否

接口调用成功的回调函数。

fail

function

否

接口调用失败的回调函数。

complete

function

否

接口调用结束的回调函数(调用成功、失败都会执行)。

示例代码

qa.addPhoneRepeatCalendar({
    title: '添加日历重复事件',
    startTime: (new Date()).getTime() / 1000 + 10,
    endTime: (new Date()).getTime() / 1000 + 600,
    alarmOffset: 60,
    allDay: false,
    location: '位置',
    alarm: true,
    description: '事件描述',
    repeatInterval: 'month',
    repeatEndTime: (new Date()).getTime() / 1000 + 800,
    success(res) {
        console.info('succeed to addPhoneRepeatCalendar.', res)
    },
    fail(err) {
        console.info('failed to addPhoneRepeatCalendar.', err)
    },
    complete(res) {
        console.info('finished to addPhoneRepeatCalendar.', res)
    }
})