# wx.addPhoneRepeatCalendar(Object object)

> 基础库 2.15.0 开始支持，低版本需做[兼容处理](1003706)。

> __以 [Promise 风格](/miniprogram/dev/framework/app-service/api.md#异步-API-返回-Promise) 调用__：支持
> 
> __[用户授权](/miniprogram/dev/framework/open-ability/authorize.md)__：需要 scope.addPhoneCalendar
> 
> __小程序插件__：不支持
> 
> __微信 鸿蒙 OS 版__：支持
> 
> __限制__：仅在点击行为时调用

## 功能描述

向系统日历添加重复事件

## 参数

### Object object


```json
[
  {
    "属性": "title",
    "类型": "string",
    "默认值": "",
    "必填": "是",
    "说明": "日历事件标题",
    "最低版本": ""
  },
  {
    "属性": "startTime",
    "类型": "number",
    "默认值": "",
    "必填": "是",
    "说明": "开始时间的 unix 时间戳 (1970年1月1日开始所经过的秒数)",
    "最低版本": ""
  },
  {
    "属性": "allDay",
    "类型": "boolean",
    "默认值": "",
    "必填": "否",
    "说明": "是否全天事件，默认 false",
    "最低版本": ""
  },
  {
    "属性": "description",
    "类型": "string",
    "默认值": "",
    "必填": "否",
    "说明": "事件说明",
    "最低版本": ""
  },
  {
    "属性": "location",
    "类型": "string",
    "默认值": "",
    "必填": "否",
    "说明": "事件位置",
    "最低版本": ""
  },
  {
    "属性": "endTime",
    "类型": "number",
    "默认值": "",
    "必填": "否",
    "说明": "结束时间的 unix 时间戳，默认与开始时间相同",
    "最低版本": ""
  },
  {
    "属性": "alarm",
    "类型": "boolean",
    "默认值": "",
    "必填": "否",
    "说明": "是否提醒，默认 true",
    "最低版本": ""
  },
  {
    "属性": "alarmOffset",
    "类型": "number",
    "默认值": "",
    "必填": "否",
    "说明": "提醒提前量，单位秒，默认 0 表示开始时提醒",
    "最低版本": ""
  },
  {
    "属性": "repeatInterval",
    "类型": "string",
    "默认值": "",
    "必填": "否",
    "说明": "重复周期，默认 month 每月重复",
    "最低版本": "",
    "子项": [
      {
        "合法值": "day",
        "说明": "每天重复"
      },
      {
        "合法值": "week",
        "说明": "每周重复"
      },
      {
        "合法值": "month",
        "说明": "每月重复。该模式日期不能大于 28 日"
      },
      {
        "合法值": "year",
        "说明": "每年重复"
      }
    ]
  },
  {
    "属性": "repeatEndTime",
    "类型": "number",
    "默认值": "",
    "必填": "否",
    "说明": "重复周期结束时间的 unix 时间戳，不填表示一直重复",
    "最低版本": ""
  },
  {
    "属性": "path",
    "类型": "string",
    "默认值": "",
    "必填": "否",
    "说明": "跳转小程序路径，必须要和 signature 一起使用，填入后会自动生成跳转链接拼接在事件说明中",
    "最低版本": "[3.7.6](1003706)"
  },
  {
    "属性": "signature",
    "类型": "string",
    "默认值": "",
    "必填": "否",
    "说明": "跳转小程序路径签名，必须要和 path 一起使用，用 session_key 对 path 签名得到的结果，即 \u0000INLINECODE_0\u0000。详见 [用户数据的签名验证和加解密](/miniprogram/dev/framework/open-ability/signature.md)",
    "最低版本": "[3.7.6](1003706)"
  },
  {
    "属性": "success",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用成功的回调函数",
    "最低版本": ""
  },
  {
    "属性": "fail",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用失败的回调函数",
    "最低版本": ""
  },
  {
    "属性": "complete",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用结束的回调函数（调用成功、失败都会执行）",
    "最低版本": ""
  }
]
```