@cloudbase/cals 1.0.3-alpha.15 → 1.0.3-alpha.17

package/lib/utils/dts/auto-generated.js

@@ -21,21 +21,28 @@ exports.wedaDTS = `declare class UserWidget {
   // ========== 快捷访问方式 ========== //
 
   /**
-   * 组件 id
+   * 组件 ID，微搭中一般由编辑器生成
    */
   readonly id: string;
   /**
-   * 组件库名称
+   * 组件库名
    */
   readonly module: string;
   /**
-   * 组件名称
+   * 组件名
    */
   readonly component: string;
-  // FIXME: 暂时不对外暴露
-  // readonly parent: UserWidget;
-  // readonly children: UserWidget[];
 
+  /**
+   * 父组件引用
+   */
+  readonly parent: UserWidget;
+  /**
+   * 子组件集合
+   */
+  readonly children: UserWidget[];
+
+  // FIXME: 暂时不对外暴露
   // closest(filter?: (parentWidget: UserWidget) => boolean): UserWidget | null;
 }
 
@@ -43,14 +50,52 @@ exports.wedaDTS = `declare class UserWidget {
 // Used Components - Don't touch me
 // Used Components Inner End
 
+// Redefine Any Type Inner Begin
+// Redefine Any Type - Don't touch me
+// Redefine Any Type Inner End
+
 declare namespace $app {
-  const id: string;
+  /**
+ * 应用 ID
+ *
+ * @privateForWeDa
+ * {"group": "sysVar", "displayType": "string", "displayName": "应用 ID"}
+ */
+const id: string;
+/**
+ * 应用名称
+ *
+ * @privateForWeDa
+ * {"group": "sysVar", "displayType": "string", "displayName": "应用名称"}
+ */
 const label: string;
+/**
+ * 应用版本
+ *
+ * @privateForWeDa
+ * {"group": "sysVar", "displayType": "string", "displayName": "应用版本"}
+ */
 const version: string;
+/**
+ * 小程序APPID
+ *
+ * @privateForWeDa
+ * {"group": "sysVar", "displayType": "string", "displayName": "小程序APPID"}
+ */
 const mpAppId: string;
+/**
+ * 小程序名称
+ *
+ * @privateForWeDa
+ * {"group": "sysVar", "displayType": "string", "displayName": "小程序名称"}
+ */
 const mpAppName: string;
 
 namespace dataset {
+
+  /**
+   * 全局变量对象
+   */
   const state: {
     // Global State Inner Begin
     // Global State 全局变量 - Don't touch me
@@ -58,12 +103,23 @@ namespace dataset {
   };
 }
 
+/**
+ * 全局 common 方法
+ */
 namespace common {
   // Global Common Inner Begin
   // Global Common 全局方法 - Don't touch me
   // Global Common Inner End
 }
 
+/**
+ * 已废弃，请改用 $w.utils
+ */
+const utils: any
+
+/**
+ * 设置页面变量
+ */
 function setState(data: Object): void;
 
 }
@@ -71,73 +127,273 @@ function setState(data: Object): void;
 declare const app = $app;
 
 declare namespace $w {
+
+  /**
+   * 当前应用实例
+   *
+   * @privateForWeDa
+   * {"group": "sysVar", "displayType": "object", "displayName": "应用信息", "schema": {"type":"object","properties":{"id":{"type":"string","title":"应用 ID"},"label":{"type":"string","title":"应用名称"},"version":{"type":"string","title":"应用版本"},"mpAppName":{"type":"string","title":"小程序名称"},"mpAppId":{"type":"string","title":"小程序APPID"}}}}
+   */
   const app = $app;
 
+  /**
+   * 当前页面信息
+   *
+   * @privateForWeDa
+   * {"group": "sysVar", "displayType": "object", "displayName": "当前页面信息", "schema": {"type":"object","properties":{"id":{"type":"string","title":"页面 ID"},"label":{"type":"string","title":"页面名称"},"path":{"type":"string","title":"页面路径"}}}}
+   */
   const page = $page;
 
+  /**
+   * 用户权限相关方法和属性
+   */
   namespace auth {
-    interface CurrentUserInfo {
+    
+interface CurrentUserInfo {
+  /**
+   * 用户 ID
+   *
+   * @privateForWeDa
+   * {"group": "sysVar", "displayType": "string", "displayName": "用户 ID"}
+   */
   userId?: string;
+  /**
+   * 手机
+   *
+   * @privateForWeDa
+   * {"group": "sysVar", "displayType": "string", "displayName": "手机"}
+   */
   phone?: string;
+  /**
+   * 用户类型
+   *
+   * @privateForWeDa
+   * {"group": "sysVar", "displayType": "number", "displayName": "用户类型"}
+   */
   type?: number;
+  /**
+   * 用户关联角色
+   *
+   * @privateForWeDa
+   * {"group": "sysVar", "displayType": "array", "displayName": "用户关联角色"}
+   */
   relatedRoles?: {
+    /**
+     * 角色 ID
+     *
+     * @privateForWeDa
+     * {"group": "sysVar", "displayType": "string", "displayName": "角色 ID"}
+     */
     id?: string;
+    /**
+     * 环境 ID
+     *
+     * @privateForWeDa
+     * {"group": "sysVar", "displayType": "string", "displayName": "环境 ID"}
+     */
     envId?: string;
+    /**
+     * 角色名称
+     *
+     * @privateForWeDa
+     * {"group": "sysVar", "displayType": "string", "displayName": "角色名称"}
+     */
     name?: string;
+    /**
+     * 角色标识
+     *
+     * @privateForWeDa
+     * {"group": "sysVar", "displayType": "string", "displayName": "角色标识"}
+     */
     roleIdentity?: string;
   }[];
+  /**
+   * 微信/企微 openId
+   *
+   * @privateForWeDa
+   * {"group": "sysVar", "displayType": "string", "displayName": "微信/企微 openId"}
+   */
   openId?: string;
+  /**
+   * 用户名称
+   *
+   * @privateForWeDa
+   * {"group": "sysVar", "displayType": "string", "displayName": "用户名称"}
+   */
   name?: string;
+  /**
+   * 用户昵称
+   *
+   * @privateForWeDa
+   * {"group": "sysVar", "displayType": "string", "displayName": "用户昵称"}
+   */
   nickName?: string;
+  /**
+   * 邮箱
+   *
+   * @privateForWeDa
+   * {"group": "sysVar", "displayType": "string", "displayName": "邮箱"}
+   */
   email?: string;
+  /**
+   * 主岗部门
+   *
+   * @privateForWeDa
+   * {"group": "sysVar", "displayType": "object", "displayName": "主岗部门"}
+   */
   mainOrg?: {
+    /**
+     * 主岗部门 ID
+     *
+     * @privateForWeDa
+     * {"group": "sysVar", "displayType": "string", "displayName": "主岗部门 ID"}
+     */
     id?: string;
+    /**
+     * 主岗部门名称
+     *
+     * @privateForWeDa
+     * {"group": "sysVar", "displayType": "string", "displayName": "主岗部门名称"}
+     */
     name?: string;
   };
+  /**
+   * 兼岗部门
+   *
+   * @privateForWeDa
+   * {"group": "sysVar", "displayType": "object", "displayName": "兼岗部门"}
+   */
   orgs?: {
+    /**
+     * 兼岗部门 ID
+     *
+     * @privateForWeDa
+     * {"group": "sysVar", "displayType": "string", "displayName": "兼岗部门 ID"}
+     */
     id?: string;
+    /**
+     * 兼岗部门名称
+     *
+     * @privateForWeDa
+     * {"group": "sysVar", "displayType": "string", "displayName": "兼岗部门名称"}
+     */
     name?: string;
   }[];
 }
+
+/**
+ * 获取用户信息
+ */
 function getUserInfo(): CurrentUserInfo;
+
+/**
+ *
+ * 登录用户信息
+ *
+ * @privateForWeDa
+ * {"group": "sysVar", "displayType": "object", "displayName": "登录用户信息", "schema": {"type":"object","properties":{"userId":{"type":"string","title":"用户 ID"},"phone":{"type":"string","title":"手机"},"type":{"type":"number","title":"用户类型"},"relatedRoles":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","title":"角色 ID"},"envId":{"type":"string","title":"环境 ID"},"name":{"type":"string","title":"角色名称"},"roleIdentity":{"type":"string","title":"角色标识"}}},"title":"用户关联角色"},"openId":{"type":"string","title":"微信/企微 openId"},"name":{"type":"string","title":"用户名称"},"nickName":{"type":"string","title":"用户昵称"},"email":{"type":"string","title":"邮箱"},"mainOrg":{"type":"object","properties":{"id":{"type":"string","title":"主岗部门 ID"},"name":{"type":"string","title":"主岗部门名称"}},"title":"主岗部门"},"orgs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","title":"兼岗部门 ID"},"name":{"type":"string","title":"兼岗部门名称"}}},"title":"兼岗部门"}}}, "doc": "https://docs.cloudbase.net/lowcode/framework/app/app#authgetuserinfoauthcurrentuser"}
+ */
 const currentUser: CurrentUserInfo;
 
   }
 
+  /**
+   * 数据源等云端能力集合
+   */
   namespace cloud {
     interface ICallDataSourceParams {
+  /**
+   * 数据源标志
+   */
   dataSourceName: string;
+  /**
+   * 数据源方法名
+   */
   methodName: string;
+  /**
+   * 方法参数，根据方法实际入参填写
+   */
   params: Object;
 }
 interface ICallFunctionParams {
+  /**
+   * TCB云函数名称
+   */
   name: string;
+  /**
+   * 云函数接收的参数，根据自己创建的云函数入参而定
+   */
   data?: any;
 }
 interface IParseOptions {
+  /**
+   * 解析 云开发云函数的通用response 包装。为true, 则返回 res.result, 此时会丢失 res.requestId 信息
+   */
   unwrapResult?: boolean;
+  /**
+   * 解析业务信息，需配合 unwrapResult 使用。为 true 时, res.result.code 非 0 抛出错误, 为 0 则返回 res.result.data
+   */
   parseBusinessInfo?: boolean;
 }
 interface ICallWorkflowParams {
+  /**
+   * 方法名称
+   */
   action: string;
+  /**
+   * 方法的自定义参数，其中 envType, envId, uid, source 均无需填写
+   */
   data?: Record<string, any>;
+  /**
+   * 是否自动将 data 的key 改为大写驼峰。默认为 true, 即使用时 data 可以采用小驼峰的 key
+   */
   capitalizeDataKey?: boolean;
 }
 
+/**
+ * 调用数据源
+ */
 function callDataSource(params: ICallDataSourceParams): any;
+
+/**
+ * 通过 cloudid 获取静态文件的 http 访问地址
+ */
 function getTempFileURL(params: string | string[]): Promise<string | string[]>;
+
+/**
+ * 调用流程
+ */
 function callWorkflow(action: ICallWorkflowParams): Promise<any>;
+
+/**
+ * 调用云开发的云函数, 与 $w.cloud.getCloudInstance 示例中的效果大体一致
+ */
 function callFunction(params: ICallFunctionParams, parseOptions?: IParseOptions): Promise<any>;
+
+/**
+ * 返回云开发web-sdk初始化后的实例(无需关心tcb环境信息及认证登录的处理), 即 tcb.init 后返回的对象, 可用该对象直接调用tcb的各种能力
+ */
 function getCloudInstance(): Promise<CloudInstance>;
 
   }
 
-  // $w.utils
+  /**
+   * 平台工具方法集合
+   */
   namespace utils {
     interface navigatorOptions {
+  /**
+   * 子应用包地址，例如 packages/subapp
+   */
   packageName: string;
+  /**
+   * 页面 ID
+   */
   pageId: string;
   data?: Record<string, any>;
+  /**
+   * query object 对象
+   */
   params?: Record<string, any>;
   events?: Record<string, (data: any) => void>;
   success(res: any);
@@ -146,31 +402,61 @@ function getCloudInstance(): Promise<CloudInstance>;
 }
 
 interface navigateBackOptions {
+  /**
+   * 返回的页面数，如果 delta 大于现有页面数，则返回到首页。
+   */
   delta: number;
 }
 
-// 显示提示
+/**
+ * 显示提示框
+ */
 function showToast(options);
 
-// 显示 loading 提示
+/**
+ * 显示全局加载中提示
+ */
 function showLoading(options);
 
-// 隐藏 loading 提示
+/**
+ * 隐藏全局加载中提示
+ */
 function hideLoading(options);
 
-// 显示模态提示
+/**
+ * 显示模态弹框
+ */
 function showModal(options);
 
-// 拨打电话
+/**
+ * 拨打电话
+ */
 function callPhone(options);
 
-// sacnCode
+/**
+ * 扫描二维码
+ */
 function scanCode(options: {
+  /**
+   * 是否只能从相机扫码，不允许从相册选择图片
+   */
   onlyFromCamera?: boolean;
   enableDefaultBehavior?: boolean;
+  /**
+   * 扫码类型
+   */
   scanType?: ('barCode' | 'qrCode')[];
+  /**
+   * 接口调用成功的回调函数
+   */
   success?: (res: { result: string; scanType: string }) => void;
+  /**
+   * 接口调用失败的回调函数
+   */
   fail?: (err: Error) => void;
+  /**
+   * 接口调用结束的回调函数（调用成功、失败都会执行）
+   */
   complete?: () => void;
 }): Promise<ScanCodeResult> | ScanCodeResult;
 
@@ -234,17 +520,39 @@ function createInterstitialAd(options);
 // 特制路由
 function navigateTo(options: navigatorOptions);
 
+/**
+ * 关闭当前页面，跳转到应用内的某个页面
+ */
 function redirectTo(options: navigatorOptions);
 
+/**
+ * 关闭所有页面，打开到应用内的某个页面
+ */
 function reLaunch(options: navigatorOptions);
 
+/**
+ * 返回首页
+ */
 function relaunchHome();
 
+/**
+ * 关闭当前页面，返回上一页面或多级页面
+ */
 function navigateBack(options: navigateBackOptions);
 
+/**
+ * 格式化枚举
+ */
+function formatEnum(path, optionname, app);
+
   }
 
-  // $w.device
+  /**
+   * 设备信息
+   *
+   * @privateForWeDa
+   * {"group": "sysVar", "displayType": "object", "displayName": "设备信息", "schema": {"type":"object","properties":{"viewport":{"type":"object","title":"窗口","properties":{"width":{"type":"number","title":"窗口宽度"},"height":{"type":"number","title":"窗口高度"}}},"networkType":{"type":"string","title":"网络类型"}}}}
+   */
   namespace device {
     /**
  * 网络类型
@@ -266,25 +574,45 @@ enum NETWORK_TYPE {
 interface IViewport {
   /**
    * 窗口宽度
+   *
+   * @privateForWeDa
+   * {"group": "sysVar", "displayType": "number", "displayName": "窗口宽度"}
    */
   width: number;
   /**
    * 窗口高度
+   *
+   * @privateForWeDa
+   * {"group": "sysVar", "displayType": "number", "displayName": "窗口高度"}
    */
   height: number;
 }
 
+/**
+ * 窗口
+ *
+ * @privateForWeDa
+ * {"group": "sysVar", "displayType": "object", "displayName": "窗口"}
+ */
 const viewport: IViewport;
+/**
+ * 网络类型
+ *
+ * @privateForWeDa
+ * {"group": "sysVar", "displayType": "string", "displayName": "网络类型"}
+ */
 const networkType: NETWORK_TYPE;
 
   }
 
-  // $w.env
+  /**
+   * 环境信息
+   *
+   * @privateForWeDa
+   * {"group": "sysVar", "displayType": "object", "displayName": "环境信息", "schema": {"type":"object","properties":{"envId":{"type":"string","title":"环境 ID"},"type":{"type":"string","title":"环境类型"}}}}
+   */
   namespace env {
-    /**
- * 环境类型
- */
-enum ENV_TYPE {
+    enum ENV_TYPE {
   /**
    * 生产
    */
@@ -295,26 +623,137 @@ enum ENV_TYPE {
   'preview' = 'preview',
 }
 
+/**
+ * 环境类型
+ *
+ * @privateForWeDa
+ * {"group": "sysVar", "displayType": "string", "displayName": "环境类型"}
+ */
 const type: ENV_TYPE;
+/**
+ * 环境 ID
+ *
+ * @privateForWeDa
+ * {"group": "sysVar", "displayType": "string", "displayName": "环境 ID"}
+ */
 const envId: string;
 
   }
 
-  // $w.wedaContext
+  /**
+   * 上下文信息
+   *
+   * @privateForWeDa
+   * {"group": "sysVar", "displayType": "object", "displayName": "上下文信息", "schema": {"type":"object","properties":{"platforms":{"type":"array","title":"应用运行终端","items":{"type":"stirng"}},"isEditorMode":{"type":"boolean","title":"是否在编辑区"}}}}
+   */
   namespace wedaContext {
-    const isEditorMode: boolean;
+    /**
+ * 是否在编辑区
+ *
+ * @privateForWeDa
+ * {"group": "sysVar", "displayType": "boolean", "displayName": "是否在编辑区"}
+ */
+const isEditorMode: boolean;
+
+/**
+ * 应用运行终端
+ *
+ * @privateForWeDa
+ * {"group": "sysVar", "displayType": "string", "displayName": "应用运行终端"}
+ */
 const platforms: ('WEB' | 'MOBILEWEB' | 'PCWEB' | 'MP')[];
 
   }
 
-   function ABS(num: number): number;
+  /**
+* 绝对值
+*
+* @remarks
+* 计算传入数字的绝对值
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "绝对值", "insertText": "ABS(1)", "subGroup": "calculation", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "计算传入数字的绝对值" , "definition": "ABS(数字):数字"}
+*/
+ function ABS(num: number): number;
+/**
+* 最小值
+*
+* @remarks
+* 返回一组数字中的最小值
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "最小值", "insertText": "Min(1, 2)", "subGroup": "calculation", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回一组数字中的最小值" , "definition": "Min(数字1, [数字2, ...]):数字"}
+*/
  function Min(...args: number[]): number;
+/**
+* 最大值
+*
+* @remarks
+* 返回一组数字中的最大值
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "最大值", "insertText": "Max(1, 2)", "subGroup": "calculation", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回一组数字中的最大值" , "definition": "Max(数字1, [数字2, ...]):数字"}
+*/
  function Max(...args: number[]): number;
+/**
+* 平均值
+*
+* @remarks
+* 返回一组数字中的平均值
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "平均值", "insertText": "Average(1, 2)", "subGroup": "calculation", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回一组数字中的平均值" , "definition": "Average(数字1, [数字2, ...]):数字"}
+*/
  function Average(...args: number[]): number;
+/**
+* 向下取整
+*
+* @remarks
+* 返回传入数字向下取整的结果
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "向下取整", "insertText": "Floor(1)", "subGroup": "calculation", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回传入数字向下取整的结果" , "definition": "Floor(数字):数字"}
+*/
  function Floor(num: number): number;
+/**
+* 向上取整
+*
+* @remarks
+* 返回传入数字向上取整的结果
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "向上取整", "insertText": "Ceiling(1)", "subGroup": "calculation", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回传入数字向上取整的结果" , "definition": "Ceiling(数字):数字"}
+*/
  function Ceiling(num: number): number;
+/**
+* 四舍五入
+*
+* @remarks
+* 返回传入数字四舍五入后的结果
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "四舍五入", "insertText": "Round(1)", "subGroup": "calculation", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回传入数字四舍五入后的结果" , "definition": "Round(数字):数字"}
+*/
  function Round(num: number): number;
+/**
+* 求和
+*
+* @remarks
+* 返回一组数字中的和
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "求和", "insertText": "Sum(1, 2)", "subGroup": "calculation", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回一组数字中的和" , "definition": "Sum(数字1, [数字2, ...]):数字"}
+*/
  function Sum(...args: number[]): number;
+/**
+* 随机数
+*
+* @remarks
+* 返回一个指定范围的伪随机数，例如 Rand(10)，返回一个范围在 10 以内的随机数
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "随机数", "insertText": "Rand(1)", "subGroup": "calculation", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回一个指定范围的伪随机数，例如 Rand(10)，返回一个范围在 10 以内的随机数" , "definition": "Rand(数字):数字"}
+*/
  function Rand(num: number): number;
 
  interface IIfObjectParam {
@@ -322,49 +761,368 @@ condition: boolean;
 consequent?: any;
 alternate?: any;
 }
- interface IIfObjectParam {
-condition: boolean;
-consequent?: any;
-alternate?: any;
-}
+/**
+* 条件分支
+*
+* @remarks
+* 按判断条件进行逻辑比较，满足时返回一个值，不满足时返回另一个值。
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "条件分支", "insertText": "If(true, '您好', 'hello')", "subGroup": "logic", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "按判断条件进行逻辑比较，满足时返回一个值，不满足时返回另一个值。" , "definition": "If(判断条件, 满足时返回的值, 不满足时返回的值):任何类型"}
+*/
  function If(params: IIfObjectParam): any;
  function If(condition: boolean, consequent?: any, alternate?: any): any;
+/**
+* 是否为空
+*
+* @remarks
+* 判断传入的文本是否为空
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "是否为空", "insertText": "IsEmpty('hello')", "subGroup": "logic", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "判断传入的文本是否为空" , "definition": "IsEmpty(值):布尔值"}
+*/
  function IsEmpty(text: string | string[]): boolean;
+/**
+* 是否为null
+*
+* @remarks
+* 判断传入的字段值是否包含数据，即不为 NULL
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "是否为null", "insertText": "NotNull(null)", "subGroup": "logic", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "判断传入的字段值是否包含数据，即不为 NULL" , "definition": "NotNull(字段):布尔值"}
+*/
  function NotNull(val: any): boolean;
+/**
+* 与
+*
+* @remarks
+* 用于确定所有判断条件是否为真
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "与", "insertText": "And(true, false)", "subGroup": "logic", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "用于确定所有判断条件是否为真" , "definition": "And(判断条件1, [判断条件2,...]):布尔值"}
+*/
  function And(...args: boolean[]): boolean;
+/**
+* 或
+*
+* @remarks
+* 任意一个判断条件为真，则结果为真；所有条件为否，结果才为否
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "或", "insertText": "Or(true, false)", "subGroup": "logic", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "任意一个判断条件为真，则结果为真；所有条件为否，结果才为否" , "definition": "Or(判断条件1, [判断条件2,...]):布尔值"}
+*/
  function Or(...args: boolean[]): boolean;
 
+/**
+* 获取文本长度
+*
+* @remarks
+* 获取传入文本的字符数
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取文本长度", "insertText": "Len('文本')", "subGroup": "text", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "获取传入文本的字符数" , "definition": "Len(文本):数字"}
+*/
  function Len(text: string): number;
+/**
+* 是否包含指定文本
+*
+* @remarks
+* 判断文本 1 是否包含文本 2
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "是否包含指定文本", "insertText": "Contains('文本1', '文本2')", "subGroup": "text", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "判断文本 1 是否包含文本 2" , "definition": "Contains(文本1, 文本2):布尔值"}
+*/
  function Contains(text1: string, text2: string): boolean;
+/**
+* 拆分文本
+*
+* @remarks
+* 根据传入的文本 2，将文本 1 拆分成文本数组，例如 Split("张三,李四,王五", ",")
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "拆分文本", "insertText": "Split('文本1', '文本2')", "subGroup": "text", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据传入的文本 2，将文本 1 拆分成文本数组，例如 Split('张三,李四,王五', ',')" , "definition": "Split(文本1,文本2):文本数组"}
+*/
  function Split(text1: string, text2: string): string[];
+/**
+* 删除开头/结尾空格和制表符
+*
+* @remarks
+* 删除文本开头和结尾的所有空格和制表符，文本中间的空格和制表符不会删除
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "删除开头/结尾空格和制表符", "insertText": "Trim('文本')", "subGroup": "text", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "删除文本开头和结尾的所有空格和制表符，文本中间的空格和制表符不会删除" , "definition": "Trim(文本):文本"}
+*/
  function Trim(text: string): string;
+/**
+* 转换为大写
+*
+* @remarks
+* 将传入的文本转为全大写文本
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "转换为大写", "insertText": "Upper('文本')", "subGroup": "text", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "将传入的文本转为全大写文本" , "definition": "Upper(文本):文本"}
+*/
  function Upper(text: string): string;
+/**
+* 转换为小写
+*
+* @remarks
+* 将传入的文本转为全小写文本
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "转换为小写", "insertText": "Lower('文本')", "subGroup": "text", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "将传入的文本转为全小写文本" , "definition": "Lower(文本):文本"}
+*/
  function Lower(text: string): string;
+/**
+* 文本拼接
+*
+* @remarks
+* 返回多个文本拼接后的新文本
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "文本拼接", "insertText": "Concat('文本1', '文本2')", "subGroup": "text", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回多个文本拼接后的新文本" , "definition": "Concat(文本1, [文本2,...]):文本"}
+*/
  function Concat(...text: string[]): string;
 
+/**
+* 获取现在时间
+*
+* @remarks
+* 返回当前系统时间，通常与其他日期时间函数搭配使用
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取现在时间", "insertText": "Now()", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回当前系统时间，通常与其他日期时间函数搭配使用" , "definition": "Now():日期时间"}
+*/
  function Now(): number;
+/**
+* 获取时间戳
+*
+* @remarks
+* 根据输入的日期时间返回时间戳
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取时间戳", "insertText": "Timestamp(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的日期时间返回时间戳" , "definition": "Timestamp(日期时间):日期时间"}
+*/
  function Timestamp(arg: number | string | Date): number;
+/**
+* 获取秒数
+*
+* @remarks
+* 根据输入的日期时间返回该时间的秒数
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取秒数", "insertText": "Second(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的日期时间返回该时间的秒数" , "definition": "Second(日期时间):数字"}
+*/
  function Second(arg: number | string | Date): number;
+/**
+* 获取分钟数
+*
+* @remarks
+* 根据输入的日期时间返回该时间的分钟部分
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取分钟数", "insertText": "Minute(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的日期时间返回该时间的分钟部分" , "definition": "Minute(日期时间):数字"}
+*/
  function Minute(arg: number | string | Date): number;
+/**
+* 获取小时数
+*
+* @remarks
+* 根据输入的日期时间返回该时间的小时部分，24小时制
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取小时数", "insertText": "Hour(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的日期时间返回该时间的小时部分，24小时制" , "definition": "Hour(日期时间):数字"}
+*/
  function Hour(arg: number | string | Date): number;
+/**
+* 获取天数
+*
+* @remarks
+* 根据输入的日期时间返回该时间的日部分，范围为 1-31
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取天数", "insertText": "Day(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的日期时间返回该时间的日部分，范围为 1-31" , "definition": "Day(日期时间):数字"}
+*/
  function Day(arg: number | string | Date): number;
+/**
+* 获取星期数
+*
+* @remarks
+* 根据输入的日期时间返回该时间的星期数
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取星期数", "insertText": "DayOfWeek(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的日期时间返回该时间的星期数" , "definition": "DayOfWeek(日期时间):数字"}
+*/
  function DayOfWeek(arg: number | string | Date): number;
+/**
+* 获取月数
+*
+* @remarks
+* 根据输入的日期时间返回该时间的月份
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取月数", "insertText": "Month(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的日期时间返回该时间的月份" , "definition": "Month(日期时间):数字"}
+*/
  function Month(arg: number | string | Date): number;
+/**
+* 获取年份
+*
+* @remarks
+* 根据输入的日期时间返回该时间的年份
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取年份", "insertText": "Year(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的日期时间返回该时间的年份" , "definition": "Year(日期时间):数字"}
+*/
  function Year(arg: number | string | Date): number;
+/**
+* 使用年月日创建日期时间
+*
+* @remarks
+* 根据输入的年月日数值返回一个日期类型的数据，例如 GetDate(2017,3,24)
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "使用年月日创建日期时间", "insertText": "GetDate(2011, 7, 2)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的年月日数值返回一个日期类型的数据，例如 GetDate(2017,3,24)" , "definition": "GetDate(数字,数字,数字):日期时间"}
+*/
  function GetDate(year: number, month: number, day: number): number;
+/**
+* 使用时间日期文本创建日期时间
+*
+* @remarks
+* 将日期时间文本根据指定格式转化为日期时间，例如 DateTimeValue("2021-12-11 01:19:12", "yyyy-MM-dd HH:mm:ss")
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "使用时间日期文本创建日期时间", "insertText": "DateTimeValue('2011-07-02', 'YYYY:MM:DD')", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "将日期时间文本根据指定格式转化为日期时间，例如 DateTimeValue('2021-12-11 01:19:12', 'yyyy-MM-dd HH:mm:ss')" , "definition": "DateTimeValue(文本, 文本):日期时间"}
+*/
  function DateTimeValue(arg: string, val: string): number;
+/**
+* 计算年龄
+*
+* @remarks
+* 根据输入的两个日期时间计算出年龄，例如 Age(Date(2017,3,24), Date(2021,3,24))
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "计算年龄", "insertText": "Age(1661334203345, 1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的两个日期时间计算出年龄，例如 Age(Date(2017,3,24), Date(2021,3,24))" , "definition": "Age(日期时间,日期时间):数字"}
+*/
  function Age(arg: number | string | Date, val: number | string | Date): number;
+/**
+* 计算当前年龄
+*
+* @remarks
+* 计算当前年龄，例如 AgeOfNow(Date(2017,3,24))
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "计算当前年龄", "insertText": "AgeOfNow(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "计算当前年龄，例如 AgeOfNow(Date(2017,3,24))" , "definition": "AgeOfNow(日期时间):数字"}
+*/
  function AgeOfNow(arg: number | string | Date): number;
+/**
+* 增加 X 天
+*
+* @remarks
+* 在传入的日期时间上增加 X 天，支持负数
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "增加 X 天", "insertText": "DateAdd(1661334203345, 1)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "在传入的日期时间上增加 X 天，支持负数" , "definition": "DateAdd(日期时间, 数字):日期时间"}
+*/
  function DateAdd(arg: number | string | Date, day: number): number;
+/**
+* 增加 X 月
+*
+* @remarks
+* 在传入的日期和时间上增加 X 月，支持负数
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "增加 X 月", "insertText": "MonthAdd(1661334203345, 1)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "在传入的日期和时间上增加 X 月，支持负数" , "definition": "MonthAdd(日期时间, 数字):日期时间"}
+*/
  function MonthAdd(arg: number | string | Date, month: number): number;
+/**
+* 增加 X 年
+*
+* @remarks
+* 在传入的日期和时间上增加 X 年，支持负数
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "增加 X 年", "insertText": "YearAdd(1661334203345, 1)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "在传入的日期和时间上增加 X 年，支持负数" , "definition": "YearAdd(日期时间, 数字):日期时间"}
+*/
  function YearAdd(arg: number | string | Date, year: number): number;
+/**
+* 天数差
+*
+* @remarks
+* 返回两个日期时间字段之间的天数差，如果为同一天，差数为零
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "天数差", "insertText": "DateDiff(1661334203345, 1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回两个日期时间字段之间的天数差，如果为同一天，差数为零" , "definition": "DateDiff(日期时间, 日期时间):数字"}
+*/
  function DateDiff(startDay: number | string | Date, endDay: number | string | Date): number;
+/**
+* 小时差
+*
+* @remarks
+* 返回两个日期时间字段之间的小时差，如果为同一小时，差数为零
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "小时差", "insertText": "HourDiff(1661334203345, 1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回两个日期时间字段之间的小时差，如果为同一小时，差数为零" , "definition": "HourDiff(日期时间, 日期时间):数字"}
+*/
  function HourDiff(startDay: number | string | Date, endDay: number | string | Date): number;
+/**
+* 分钟差
+*
+* @remarks
+* 返回两个日期时间字段之间的分钟差，如果为同一分钟，差数为零
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "分钟差", "insertText": "MinuteDiff(1661334203345, 1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回两个日期时间字段之间的分钟差，如果为同一分钟，差数为零" , "definition": "MinuteDiff(日期时间, 日期时间):数字"}
+*/
  function MinuteDiff(startDay: number | string | Date, endDay: number | string | Date): number;
+/**
+* 秒数差
+*
+* @remarks
+* 返回两个日期时间字段之间的天数差，如果为同一天，差数为零
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "秒数差", "insertText": "SecondDiff(1661334203345, 1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回两个日期时间字段之间的天数差，如果为同一天，差数为零" , "definition": "SecondDiff(日期时间, 日期时间):数字"}
+*/
  function SecondDiff(startDay: number | string | Date, endDay: number | string | Date): number;
+/**
+* 月数差
+*
+* @remarks
+* 返回两个日期时间字段之间的月数差，如果为同一月，差数为零
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "月数差", "insertText": "MonthDiff(1661334203345, 1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回两个日期时间字段之间的月数差，如果为同一月，差数为零" , "definition": "MonthDiff(日期时间, 日期时间):数字"}
+*/
  function MonthDiff(startDay: number | string | Date, endDay: number | string | Date): number;
+/**
+* 年数差
+*
+* @remarks
+* 返回两个日期时间字段之间的年数差，如果为同一年，差数为零
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "年数差", "insertText": "YearDiff(1661334203345, 1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回两个日期时间字段之间的年数差，如果为同一年，差数为零" , "definition": "YearDiff(日期时间, 日期时间):数字"}
+*/
  function YearDiff(startDay: number | string | Date, endDay: number | string | Date): number;
+/**
+* 日期时间格式化
+*
+* @remarks
+* 格式化日期时间为指定格式的文本，例如 DateText(Date(2017,3,24), "yyyy-MM-dd HH:mm:ss")
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "日期时间格式化", "insertText": "DateText(1661334203345, 'YYYY-MM-DD HH:mm:ss')", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "格式化日期时间为指定格式的文本，例如 DateText(Date(2017,3,24), 'yyyy-MM-dd HH:mm:ss')" , "definition": "DateText(日期时间, 文本):文本"}
+*/
  function DateText(createdTime: number | string | Date, text: string): string;
+/**
+* 是否为今天
+*
+* @remarks
+* 判断传入的日期时间是否为今天，例如 IsToday(Date(2022,4,8))
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "是否为今天", "insertText": "IsToday(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "判断传入的日期时间是否为今天，例如 IsToday(Date(2022,4,8))" , "definition": "IsToday(日期时间):布尔值"}
+*/
  function IsToday(date: number | string | Date): boolean;
 
 
@@ -388,28 +1146,62 @@ declare const forItems = $for;
 
 // $page Begin
 declare namespace $page {
-  const id: string;
+  /**
+ * 页面 ID
+ *
+ * @privateForWeDa
+ * {"group": "sysVar", "displayType": "string", "displayName": "页面 ID"}
+ */
+const id: string;
+/**
+ * 页面名称
+ *
+ * @privateForWeDa
+ * {"group": "sysVar", "displayType": "string", "displayName": "页面名称"}
+ */
 const label: string;
+/**
+ * 页面路径
+ *
+ * @privateForWeDa
+ * {"group": "sysVar", "displayType": "string", "displayName": "页面路径"}
+ */
 const path: string;
 
+/**
+ * 页面数据对象
+ */
 namespace dataset {
+  /**
+   * 页面变量
+   */
   const state: {
     // Page State Inner Begin
     // Page State 页面变量 - Don't touch me
     // Page State Inner End
   };
+  /**
+   * 页面参数
+   */
   const params: {
     // Page Param Inner Begin
     // Page Param 页面参数 - Don't touch me
     // Page Param Inner End
   };
 }
+
+/**
+ * 页面定义 handler 方法
+ */
 namespace handler {
   // Page Handler Inner Begin
   // Page Handler 页面方法 - Don't touch me
   // Page Handler Inner End
 }
 
+/**
+ * 设置页面变量
+ */
 function setState(userSetState: Record<string, any>): void;
 
 }
@@ -449,14 +1241,95 @@ declare namespace $comp {
 
 // Global Formula Begin
 
+/**
+* 绝对值
+*
+* @remarks
+* 计算传入数字的绝对值
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "绝对值", "insertText": "ABS(1)", "subGroup": "calculation", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "计算传入数字的绝对值" , "definition": "ABS(数字):数字"}
+*/
 declare function ABS(num: number): number;
+/**
+* 最小值
+*
+* @remarks
+* 返回一组数字中的最小值
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "最小值", "insertText": "Min(1, 2)", "subGroup": "calculation", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回一组数字中的最小值" , "definition": "Min(数字1, [数字2, ...]):数字"}
+*/
 declare function Min(...args: number[]): number;
+/**
+* 最大值
+*
+* @remarks
+* 返回一组数字中的最大值
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "最大值", "insertText": "Max(1, 2)", "subGroup": "calculation", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回一组数字中的最大值" , "definition": "Max(数字1, [数字2, ...]):数字"}
+*/
 declare function Max(...args: number[]): number;
+/**
+* 平均值
+*
+* @remarks
+* 返回一组数字中的平均值
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "平均值", "insertText": "Average(1, 2)", "subGroup": "calculation", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回一组数字中的平均值" , "definition": "Average(数字1, [数字2, ...]):数字"}
+*/
 declare function Average(...args: number[]): number;
+/**
+* 向下取整
+*
+* @remarks
+* 返回传入数字向下取整的结果
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "向下取整", "insertText": "Floor(1)", "subGroup": "calculation", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回传入数字向下取整的结果" , "definition": "Floor(数字):数字"}
+*/
 declare function Floor(num: number): number;
+/**
+* 向上取整
+*
+* @remarks
+* 返回传入数字向上取整的结果
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "向上取整", "insertText": "Ceiling(1)", "subGroup": "calculation", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回传入数字向上取整的结果" , "definition": "Ceiling(数字):数字"}
+*/
 declare function Ceiling(num: number): number;
+/**
+* 四舍五入
+*
+* @remarks
+* 返回传入数字四舍五入后的结果
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "四舍五入", "insertText": "Round(1)", "subGroup": "calculation", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回传入数字四舍五入后的结果" , "definition": "Round(数字):数字"}
+*/
 declare function Round(num: number): number;
+/**
+* 求和
+*
+* @remarks
+* 返回一组数字中的和
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "求和", "insertText": "Sum(1, 2)", "subGroup": "calculation", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回一组数字中的和" , "definition": "Sum(数字1, [数字2, ...]):数字"}
+*/
 declare function Sum(...args: number[]): number;
+/**
+* 随机数
+*
+* @remarks
+* 返回一个指定范围的伪随机数，例如 Rand(10)，返回一个范围在 10 以内的随机数
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "随机数", "insertText": "Rand(1)", "subGroup": "calculation", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回一个指定范围的伪随机数，例如 Rand(10)，返回一个范围在 10 以内的随机数" , "definition": "Rand(数字):数字"}
+*/
 declare function Rand(num: number): number;
 
 declare interface IIfObjectParam {
@@ -464,49 +1337,368 @@ condition: boolean;
 consequent?: any;
 alternate?: any;
 }
-declare interface IIfObjectParam {
-condition: boolean;
-consequent?: any;
-alternate?: any;
-}
+/**
+* 条件分支
+*
+* @remarks
+* 按判断条件进行逻辑比较，满足时返回一个值，不满足时返回另一个值。
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "条件分支", "insertText": "If(true, '您好', 'hello')", "subGroup": "logic", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "按判断条件进行逻辑比较，满足时返回一个值，不满足时返回另一个值。" , "definition": "If(判断条件, 满足时返回的值, 不满足时返回的值):任何类型"}
+*/
 declare function If(params: IIfObjectParam): any;
 declare function If(condition: boolean, consequent?: any, alternate?: any): any;
+/**
+* 是否为空
+*
+* @remarks
+* 判断传入的文本是否为空
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "是否为空", "insertText": "IsEmpty('hello')", "subGroup": "logic", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "判断传入的文本是否为空" , "definition": "IsEmpty(值):布尔值"}
+*/
 declare function IsEmpty(text: string | string[]): boolean;
+/**
+* 是否为null
+*
+* @remarks
+* 判断传入的字段值是否包含数据，即不为 NULL
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "是否为null", "insertText": "NotNull(null)", "subGroup": "logic", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "判断传入的字段值是否包含数据，即不为 NULL" , "definition": "NotNull(字段):布尔值"}
+*/
 declare function NotNull(val: any): boolean;
+/**
+* 与
+*
+* @remarks
+* 用于确定所有判断条件是否为真
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "与", "insertText": "And(true, false)", "subGroup": "logic", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "用于确定所有判断条件是否为真" , "definition": "And(判断条件1, [判断条件2,...]):布尔值"}
+*/
 declare function And(...args: boolean[]): boolean;
+/**
+* 或
+*
+* @remarks
+* 任意一个判断条件为真，则结果为真；所有条件为否，结果才为否
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "或", "insertText": "Or(true, false)", "subGroup": "logic", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "任意一个判断条件为真，则结果为真；所有条件为否，结果才为否" , "definition": "Or(判断条件1, [判断条件2,...]):布尔值"}
+*/
 declare function Or(...args: boolean[]): boolean;
 
+/**
+* 获取文本长度
+*
+* @remarks
+* 获取传入文本的字符数
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取文本长度", "insertText": "Len('文本')", "subGroup": "text", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "获取传入文本的字符数" , "definition": "Len(文本):数字"}
+*/
 declare function Len(text: string): number;
+/**
+* 是否包含指定文本
+*
+* @remarks
+* 判断文本 1 是否包含文本 2
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "是否包含指定文本", "insertText": "Contains('文本1', '文本2')", "subGroup": "text", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "判断文本 1 是否包含文本 2" , "definition": "Contains(文本1, 文本2):布尔值"}
+*/
 declare function Contains(text1: string, text2: string): boolean;
+/**
+* 拆分文本
+*
+* @remarks
+* 根据传入的文本 2，将文本 1 拆分成文本数组，例如 Split("张三,李四,王五", ",")
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "拆分文本", "insertText": "Split('文本1', '文本2')", "subGroup": "text", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据传入的文本 2，将文本 1 拆分成文本数组，例如 Split('张三,李四,王五', ',')" , "definition": "Split(文本1,文本2):文本数组"}
+*/
 declare function Split(text1: string, text2: string): string[];
+/**
+* 删除开头/结尾空格和制表符
+*
+* @remarks
+* 删除文本开头和结尾的所有空格和制表符，文本中间的空格和制表符不会删除
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "删除开头/结尾空格和制表符", "insertText": "Trim('文本')", "subGroup": "text", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "删除文本开头和结尾的所有空格和制表符，文本中间的空格和制表符不会删除" , "definition": "Trim(文本):文本"}
+*/
 declare function Trim(text: string): string;
+/**
+* 转换为大写
+*
+* @remarks
+* 将传入的文本转为全大写文本
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "转换为大写", "insertText": "Upper('文本')", "subGroup": "text", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "将传入的文本转为全大写文本" , "definition": "Upper(文本):文本"}
+*/
 declare function Upper(text: string): string;
+/**
+* 转换为小写
+*
+* @remarks
+* 将传入的文本转为全小写文本
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "转换为小写", "insertText": "Lower('文本')", "subGroup": "text", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "将传入的文本转为全小写文本" , "definition": "Lower(文本):文本"}
+*/
 declare function Lower(text: string): string;
+/**
+* 文本拼接
+*
+* @remarks
+* 返回多个文本拼接后的新文本
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "文本拼接", "insertText": "Concat('文本1', '文本2')", "subGroup": "text", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回多个文本拼接后的新文本" , "definition": "Concat(文本1, [文本2,...]):文本"}
+*/
 declare function Concat(...text: string[]): string;
 
+/**
+* 获取现在时间
+*
+* @remarks
+* 返回当前系统时间，通常与其他日期时间函数搭配使用
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取现在时间", "insertText": "Now()", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回当前系统时间，通常与其他日期时间函数搭配使用" , "definition": "Now():日期时间"}
+*/
 declare function Now(): number;
+/**
+* 获取时间戳
+*
+* @remarks
+* 根据输入的日期时间返回时间戳
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取时间戳", "insertText": "Timestamp(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的日期时间返回时间戳" , "definition": "Timestamp(日期时间):日期时间"}
+*/
 declare function Timestamp(arg: number | string | Date): number;
+/**
+* 获取秒数
+*
+* @remarks
+* 根据输入的日期时间返回该时间的秒数
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取秒数", "insertText": "Second(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的日期时间返回该时间的秒数" , "definition": "Second(日期时间):数字"}
+*/
 declare function Second(arg: number | string | Date): number;
+/**
+* 获取分钟数
+*
+* @remarks
+* 根据输入的日期时间返回该时间的分钟部分
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取分钟数", "insertText": "Minute(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的日期时间返回该时间的分钟部分" , "definition": "Minute(日期时间):数字"}
+*/
 declare function Minute(arg: number | string | Date): number;
+/**
+* 获取小时数
+*
+* @remarks
+* 根据输入的日期时间返回该时间的小时部分，24小时制
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取小时数", "insertText": "Hour(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的日期时间返回该时间的小时部分，24小时制" , "definition": "Hour(日期时间):数字"}
+*/
 declare function Hour(arg: number | string | Date): number;
+/**
+* 获取天数
+*
+* @remarks
+* 根据输入的日期时间返回该时间的日部分，范围为 1-31
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取天数", "insertText": "Day(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的日期时间返回该时间的日部分，范围为 1-31" , "definition": "Day(日期时间):数字"}
+*/
 declare function Day(arg: number | string | Date): number;
+/**
+* 获取星期数
+*
+* @remarks
+* 根据输入的日期时间返回该时间的星期数
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取星期数", "insertText": "DayOfWeek(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的日期时间返回该时间的星期数" , "definition": "DayOfWeek(日期时间):数字"}
+*/
 declare function DayOfWeek(arg: number | string | Date): number;
+/**
+* 获取月数
+*
+* @remarks
+* 根据输入的日期时间返回该时间的月份
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取月数", "insertText": "Month(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的日期时间返回该时间的月份" , "definition": "Month(日期时间):数字"}
+*/
 declare function Month(arg: number | string | Date): number;
+/**
+* 获取年份
+*
+* @remarks
+* 根据输入的日期时间返回该时间的年份
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "获取年份", "insertText": "Year(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的日期时间返回该时间的年份" , "definition": "Year(日期时间):数字"}
+*/
 declare function Year(arg: number | string | Date): number;
+/**
+* 使用年月日创建日期时间
+*
+* @remarks
+* 根据输入的年月日数值返回一个日期类型的数据，例如 GetDate(2017,3,24)
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "使用年月日创建日期时间", "insertText": "GetDate(2011, 7, 2)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的年月日数值返回一个日期类型的数据，例如 GetDate(2017,3,24)" , "definition": "GetDate(数字,数字,数字):日期时间"}
+*/
 declare function GetDate(year: number, month: number, day: number): number;
+/**
+* 使用时间日期文本创建日期时间
+*
+* @remarks
+* 将日期时间文本根据指定格式转化为日期时间，例如 DateTimeValue("2021-12-11 01:19:12", "yyyy-MM-dd HH:mm:ss")
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "使用时间日期文本创建日期时间", "insertText": "DateTimeValue('2011-07-02', 'YYYY:MM:DD')", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "将日期时间文本根据指定格式转化为日期时间，例如 DateTimeValue('2021-12-11 01:19:12', 'yyyy-MM-dd HH:mm:ss')" , "definition": "DateTimeValue(文本, 文本):日期时间"}
+*/
 declare function DateTimeValue(arg: string, val: string): number;
+/**
+* 计算年龄
+*
+* @remarks
+* 根据输入的两个日期时间计算出年龄，例如 Age(Date(2017,3,24), Date(2021,3,24))
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "计算年龄", "insertText": "Age(1661334203345, 1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "根据输入的两个日期时间计算出年龄，例如 Age(Date(2017,3,24), Date(2021,3,24))" , "definition": "Age(日期时间,日期时间):数字"}
+*/
 declare function Age(arg: number | string | Date, val: number | string | Date): number;
+/**
+* 计算当前年龄
+*
+* @remarks
+* 计算当前年龄，例如 AgeOfNow(Date(2017,3,24))
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "计算当前年龄", "insertText": "AgeOfNow(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "计算当前年龄，例如 AgeOfNow(Date(2017,3,24))" , "definition": "AgeOfNow(日期时间):数字"}
+*/
 declare function AgeOfNow(arg: number | string | Date): number;
+/**
+* 增加 X 天
+*
+* @remarks
+* 在传入的日期时间上增加 X 天，支持负数
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "增加 X 天", "insertText": "DateAdd(1661334203345, 1)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "在传入的日期时间上增加 X 天，支持负数" , "definition": "DateAdd(日期时间, 数字):日期时间"}
+*/
 declare function DateAdd(arg: number | string | Date, day: number): number;
+/**
+* 增加 X 月
+*
+* @remarks
+* 在传入的日期和时间上增加 X 月，支持负数
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "增加 X 月", "insertText": "MonthAdd(1661334203345, 1)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "在传入的日期和时间上增加 X 月，支持负数" , "definition": "MonthAdd(日期时间, 数字):日期时间"}
+*/
 declare function MonthAdd(arg: number | string | Date, month: number): number;
+/**
+* 增加 X 年
+*
+* @remarks
+* 在传入的日期和时间上增加 X 年，支持负数
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "增加 X 年", "insertText": "YearAdd(1661334203345, 1)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "在传入的日期和时间上增加 X 年，支持负数" , "definition": "YearAdd(日期时间, 数字):日期时间"}
+*/
 declare function YearAdd(arg: number | string | Date, year: number): number;
+/**
+* 天数差
+*
+* @remarks
+* 返回两个日期时间字段之间的天数差，如果为同一天，差数为零
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "天数差", "insertText": "DateDiff(1661334203345, 1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回两个日期时间字段之间的天数差，如果为同一天，差数为零" , "definition": "DateDiff(日期时间, 日期时间):数字"}
+*/
 declare function DateDiff(startDay: number | string | Date, endDay: number | string | Date): number;
+/**
+* 小时差
+*
+* @remarks
+* 返回两个日期时间字段之间的小时差，如果为同一小时，差数为零
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "小时差", "insertText": "HourDiff(1661334203345, 1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回两个日期时间字段之间的小时差，如果为同一小时，差数为零" , "definition": "HourDiff(日期时间, 日期时间):数字"}
+*/
 declare function HourDiff(startDay: number | string | Date, endDay: number | string | Date): number;
+/**
+* 分钟差
+*
+* @remarks
+* 返回两个日期时间字段之间的分钟差，如果为同一分钟，差数为零
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "分钟差", "insertText": "MinuteDiff(1661334203345, 1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回两个日期时间字段之间的分钟差，如果为同一分钟，差数为零" , "definition": "MinuteDiff(日期时间, 日期时间):数字"}
+*/
 declare function MinuteDiff(startDay: number | string | Date, endDay: number | string | Date): number;
+/**
+* 秒数差
+*
+* @remarks
+* 返回两个日期时间字段之间的天数差，如果为同一天，差数为零
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "秒数差", "insertText": "SecondDiff(1661334203345, 1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回两个日期时间字段之间的天数差，如果为同一天，差数为零" , "definition": "SecondDiff(日期时间, 日期时间):数字"}
+*/
 declare function SecondDiff(startDay: number | string | Date, endDay: number | string | Date): number;
+/**
+* 月数差
+*
+* @remarks
+* 返回两个日期时间字段之间的月数差，如果为同一月，差数为零
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "月数差", "insertText": "MonthDiff(1661334203345, 1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回两个日期时间字段之间的月数差，如果为同一月，差数为零" , "definition": "MonthDiff(日期时间, 日期时间):数字"}
+*/
 declare function MonthDiff(startDay: number | string | Date, endDay: number | string | Date): number;
+/**
+* 年数差
+*
+* @remarks
+* 返回两个日期时间字段之间的年数差，如果为同一年，差数为零
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "年数差", "insertText": "YearDiff(1661334203345, 1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "返回两个日期时间字段之间的年数差，如果为同一年，差数为零" , "definition": "YearDiff(日期时间, 日期时间):数字"}
+*/
 declare function YearDiff(startDay: number | string | Date, endDay: number | string | Date): number;
+/**
+* 日期时间格式化
+*
+* @remarks
+* 格式化日期时间为指定格式的文本，例如 DateText(Date(2017,3,24), "yyyy-MM-dd HH:mm:ss")
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "日期时间格式化", "insertText": "DateText(1661334203345, 'YYYY-MM-DD HH:mm:ss')", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "格式化日期时间为指定格式的文本，例如 DateText(Date(2017,3,24), 'yyyy-MM-dd HH:mm:ss')" , "definition": "DateText(日期时间, 文本):文本"}
+*/
 declare function DateText(createdTime: number | string | Date, text: string): string;
+/**
+* 是否为今天
+*
+* @remarks
+* 判断传入的日期时间是否为今天，例如 IsToday(Date(2022,4,8))
+*
+* @privateForWeDa
+* {"group": "formula", "displayType": "function", "displayName": "是否为今天", "insertText": "IsToday(1661334203345)", "subGroup": "time", "doc": "https://cloud.tencent.com/document/product/1301/76328" , "description": "判断传入的日期时间是否为今天，例如 IsToday(Date(2022,4,8))" , "definition": "IsToday(日期时间):布尔值"}
+*/
 declare function IsToday(date: number | string | Date): boolean;