@wecom/wecom-openclaw-plugin 2026.7.2 → 2026.8.17-beta.1

package/skills/wecomcli-smartpage/references/formula/datetime.md

@@ -0,0 +1,283 @@
+# 日期时间公式函数(`DATE`, `DATEDIF`, `DATEVALUE`, `DAY`, `HOUR`, `MINUTE`, `MONTH`, `NETWORKDAYS`, `NOW`, `SECOND`, `TODAY`, `WEEKDAY`, `WEEKNUM`, `WORKDAY`, `YEAR`)
+
+> 用于获取当前日期、日期计算、日期差值、工作日计算等日期时间处理，适用于倒计时显示、工龄计算、截止日期判断等场景。
+
+---
+
+## DATE - 构造日期
+
+**表达式**: `DATE(年, 月, 日)`
+
+**函数说明**: 将代表年、月、日的数字转换为日期。
+
+**参数说明**:
+- 年：必需，年参数的值可以包含一到四位数字
+- 月：必需，一个正整数或负整数，表示一年中从1月至12月（一月到十二月）的各个月
+- 日：必需，一个正整数或负整数，表示一月中从01日到31日的各天
+
+**示例**:
+```
+DATE(2026,04,18) => 2026/4/18
+DATE(2026, 1, 1)
+```
+
+---
+
+## DATEDIF - 日期差
+
+**表达式**: `DATEDIF(起始日期, 结束日期, 单位)`
+
+**函数说明**: 计算起始日期和结束日期之间的天数、月数或年数。
+
+**参数说明**:
+- 起始日期：必需，计算中要使用的开始日期。必须是以下一种：日期格式的列、返回日期类型的函数、或数字
+- 结束日期：必需，计算中要使用的结束日期。必须是以下一种：日期格式的列、返回日期类型的函数、或数字
+- 单位：必需，某种时间单位的缩写字符串。例如， "Y"代表年数、"M" 代表月数、"D"代表天数、"MD"代表同月间隔天数、"YM"代表同年间隔月数、"YD"代表同年间隔天数
+
+**示例**:
+```
+DATEDIF("2026/4/10","2026/4/18","D") =>8
+DATEDIF([入职日期], TODAY(), "Y") // 计算工龄（年）
+DATEDIF([开始日期], [结束日期], "D") // 计算项目持续天数
+DATEDIF([开始日期], [结束日期], "M") // 计算相差月数
+```
+
+---
+
+## DATEVALUE - 日期值转换
+
+**表达式**: `DATEVALUE(日期字符串)`
+
+**函数说明**: 将日期字符串转换为数字。数字代表是从距离1900年1月1日的天数。
+
+**参数说明**: 日期字符串：必需。代表采用日期格式的日期文本，或是对包含这种文本的字段
+
+**示例**:
+```
+DATEVALUE("2026/04/18") => 46130
+DATEVALUE("2026-01-01")
+```
+
+---
+
+## DAY - 获取日期
+
+**表达式**: `DAY(日期)`
+
+**函数说明**: 获取日期（或转换为数值的日期）对应的日。
+
+**参数说明**: 日期：必需，从中提取具体几号的日期
+
+**示例**:
+```
+DAY("2026-4-20 10:30:55") => 20
+DAY([开工日期])
+```
+
+---
+
+## HOUR - 获取小时
+
+**表达式**: `HOUR(时间)`
+
+**函数说明**: 获取时间（或转换为数值的时间）的小时数。
+
+**参数说明**: 时间：必需，从中提取小时数的时间
+
+**示例**:
+```
+HOUR("2026-4-20 10:30:55") => 10
+HOUR([打卡时间])
+```
+
+---
+
+## MINUTE - 获取分钟
+
+**表达式**: `MINUTE(时间)`
+
+**函数说明**: 获取时间（或转换为数值的时间）的分钟数
+
+**参数说明**: 时间：必需，从中提取分钟数的时间
+
+**示例**:
+```
+MINUTE("2026-4-20 10:30:55") => 30
+MINUTE([会议开始时间])
+```
+
+---
+
+## MONTH - 获取月份
+
+**表达式**: `MONTH(日期)`
+
+**函数说明**: 获取日期（或转换为数值的日期）的月份
+
+**参数说明**: 日期：必需，从中提取月份的日期
+
+**示例**:
+```
+MONTH("2026-4-20") => 4
+MONTH([生日])
+```
+
+---
+
+## NETWORKDAYS - 工作日天数
+
+**表达式**: `NETWORKDAYS(开始日期,终止日期,[节假日])`
+
+**函数说明**: 返回开始日期和终止日期之间的净工作日天数。工作日不包括周末和专门指定的假期。
+
+**参数说明**:
+- 开始日期：必需，一个代表开始日期的日期
+- 终止日期：必需，一个代表终止日期的日期
+- 节假日：可选，默认为双休日，也可加上列入该参数的日期范围或日期字段
+
+**示例**:
+```
+NETWORKDAYS("2026/4/18", "2026/4/25", LIST("2026/4/19", "2026/5/18")) => 5
+//计算 2026/4/18 和 2026/4/25 之间除去2026/4/19和双休日后的天数
+NETWORKDAYS([开始日期], [结束日期])
+```
+
+---
+
+## NOW - 当前日期时间
+
+**表达式**: `NOW()`
+
+**函数说明**: 返回当前日期和时间
+
+**参数说明**: NOW 函数语法没有参数
+
+**示例**:
+```
+NOW()=>返回当前时间
+```
+
+---
+
+## SECOND - 获取秒数
+
+**表达式**: `SECOND(时间)`
+
+**函数说明**: 获取时间（或转换为数值的时间）的秒数
+
+**参数说明**: 时间：必需，从中提取秒数的时间
+
+**示例**:
+```
+SECOND("2026-4-20 10:30:55") => 55
+```
+
+---
+
+## TODAY - 当前日期
+
+**表达式**: `TODAY()`
+
+**函数说明**: 返回今天的日期。
+
+**参数说明**: TODAY 函数语法没有参数
+
+**示例**:
+```
+TODAY() => 返回当前日期
+IF([截止日期] < TODAY(), "已超期", "进行中")
+```
+
+---
+
+## WEEKDAY - 星期几
+
+**表达式**: `WEEKDAY(日期值, [类型])`
+
+**函数说明**: 返回对应于某个日期的一周中的第几天。 默认情况下，天数是1（星期日）到7（星期六）范围内的整数。
+
+**参数说明**:
+- 日期值：必需，要查找的那一天的日期
+- 类型：可选。用于确定返回值类型的数字
+  - 输入1或省略，返回数字1（星期日）到7（星期六）
+  - 输入2，返回数字 1（星期一）到7（星期日）
+  - 输入3，返回数字0（星期一）到6（星期六）
+  - 输入11，返回数字 1（星期一）到7（星期日）
+  - 输入12，返回数字 1（星期二）到7（星期一）
+  - 输入13，返回数字1（星期三）到7（星期二）
+  - 输入14，返回数字 1（星期四）到7（星期三）
+  - 输入15，返回数字 1（星期五）到7（星期四）
+  - 输入16，返回数字 1（星期六）到7（星期五）
+  - 输入17，返回数字1（星期日）到7（星期六）
+
+**示例**:
+```
+WEEKDAY("2026/4/15", 3) => 2
+WEEKDAY([日期])
+// 判断是否为周末
+IF(OR(WEEKDAY([日期]) = 1, WEEKDAY([日期]) = 7), "周末", "工作日")
+```
+
+---
+
+## WEEKNUM - 第几周
+
+**表达式**: `WEEKNUM(日期, [类型])`
+
+**函数说明**: 返回日期在当前年份的第几周
+
+**参数说明**:
+- 日期：必需。需要返回所在周序号的目标日期，可以是日期字段或格式为日期类型的数字、公式字段等
+- 类型：可选。默认为 1，表示一周的第 1 天从星期几开始
+  - 1或省略 代表星期天开始
+  - 2 代表星期一开始
+  - 11 代表星期一开始
+  - 12 代表星期二开始
+  - 13 代表星期三开始
+  - 14 代表星期四开始
+  - 15 代表星期五开始
+  - 16 代表星期六开始
+  - 17 代表星期日开始
+  - 21代表星期一开始
+
+**示例**:
+```
+WEEKNUM("2000-01-01")=> 1
+WEEKNUM([日期])
+```
+
+---
+
+## WORKDAY - 工作日计算
+
+**表达式**: `WORKDAY(起始日期, 天数, [节假日])`
+
+**函数说明**: 返回起始日期之前或之后指定工作日数的日期。工作日不包含周末以及节假日。
+
+**参数说明**:
+- 开始日期：必需，计算的开始日期
+- 天数：必需，开始日期之前或之后的非周末和非假日的天数。正值代表未来的日期；负值代表过去的日期。如果天数不是整数，则会截除其小数部分
+- 节假日：可选，默认双休日，一个范围或数组常量
+
+**示例**:
+```
+WORKDAY(DATE(2026,4,15), 4, LIST("2026/4/16", "2026/5/18")) => "2026/4/22"
+//在计算工期时会将跳过 2026/5/18 和 2026/4/16 和双休日
+WORKDAY(TODAY(), 3)  // 3个工作日后的日期
+```
+
+---
+
+## YEAR - 获取年份
+
+**表达式**: `YEAR(日期)`
+
+**函数说明**: 获取日期（或转换为数值的日期）的年份
+
+**参数说明**: 日期：必需， 从中提取年份的日期
+
+**示例**:
+```
+YEAR("2026-4-20") => 2026
+YEAR([入职日期])
+```

package/skills/wecomcli-smartpage/references/formula/logic.md

@@ -0,0 +1,247 @@
+# 逻辑判断公式函数(`AND`, `FALSE`, `IF`, `IFBLANK`, `IFERROR`, `IFS`, `ISBLANK`, `ISERROR`, `ISNULL`, `NOT`, `OR`, `SWITCH`, `TRUE`)
+
+> 用于条件判断、状态标记、错误处理、空值处理等逻辑控制，适用于数据校验、状态显示、条件渲染等场景。
+
+---
+
+## AND - 逻辑与
+
+**表达式**: `AND(逻辑表达式1, [逻辑表达式2, ...])`
+
+**函数说明**: 使用 AND 函数，它是一个逻辑函数，用于确定测试中的所有条件是否均为 TRUE。所有参数的计算结果为 TRUE 时，AND 函数返回 TRUE；只要有一个参数的计算结果为 FALSE，即返回 FALSE。
+
+[警告] **不能使用 && 运算符**：公式系统不支持 JavaScript 的 && 运算符，必须使用 AND() 函数
+
+**参数说明**: 逻辑表达式1：必填， 一个表达式或对包含表达式字段的引用，代表某种逻辑值，即 TRUE 或 FALSE。
+
+**示例**:
+```
+[正例] AND(2>1, 92>100)
+[正例] AND([Each].[状态]="已完成", [Each].[金额]>1000)
+
+[反例] 2>1 && 92>100  // 不支持 &&
+[反例] [状态]="已完成" && [金额]>1000  // 不支持 &&
+[反例] [状态]="已完成" AND [金额]>1000  // AND不能写在条件中间！
+```
+
+---
+
+## FALSE - 假值
+
+**表达式**: `FALSE()`
+
+**函数说明**: 返回逻辑值FALSE。
+
+**参数说明**: FALSE函数语法没有参数
+
+**示例**:
+```
+FALSE() => FALSE
+```
+
+---
+
+## IF - 简单条件
+
+**表达式**: `IF(逻辑表达式, 为 TRUE 时的返回值, [为 FALSE 时的返回值])`
+
+**函数说明**: 当逻辑表达式结果为TRUE时返回一个值，为FALSE时返回一个值。
+
+**参数说明**:
+- 逻辑表达式：一个表达式或对包含表达式字段的引用，代表某种逻辑值，即 TRUE 或 FALSE
+- 为 TRUE 时的返回值：当"逻辑表达式"为 TRUE 时的返回值
+- [为 FALSE 时的返回值]：当"逻辑表达式"为 FALSE 时的返回值
+
+**示例**:
+```
+IF([是否完成]="是",1,2) ，表示如果是否完成等于是，则返回 1, 否则返回 2。
+IF([分数] >= 60, "及格", "不及格")
+IF([金额] > 10000, "大客户", "普通客户")
+IF([分数] >= 90, "优秀", IF([分数] >= 60, "及格", "不及格"))
+```
+
+---
+
+## IFBLANK - 空值判断
+
+**表达式**: `IFBLANK(值, 空值情况的返回值)`
+
+**函数说明**: 检测目标值是否为空，为空则返回第二个参数对应的值，非空则返回值本身
+
+**参数说明**:
+- 值： 必需。 非空时返回的值
+- 空值情况返回的值：值为空返回的值
+
+**示例**:
+```
+IFBLANK([商品名称],"未登记") => 商品名称
+商品名称为空，则返回"未登记"
+IFBLANK([备注], "无备注")
+```
+
+---
+
+## IFERROR - 错误处理
+
+**表达式**: `IFERROR(值, 错误情况的返回值)`
+
+**函数说明**: 检查目标值是否错误，如果错误，则返回指定的值；否则返回值的结果。 使用IFERROR函数可捕获和处理公式中的错误。
+
+**参数说明**:
+- 值：必需。检查是否存在错误的参数
+- 错误情况的返回值：必需。公式的计算结果错误时返回的值
+
+**示例**:
+```
+IFERROR([总价]/[数量],"计算中有错误") => "计算中有错误"
+IFERROR([金额] / [数量], 0)
+```
+
+---
+
+## IFS - 多条件判断
+
+**表达式**: `IFS(条件1, 值1, [条件2, ...], [值2, ...])`
+
+**函数说明**: 判断是否满足一个或多个条件并返回第一个 TRUE 条件对应的结果。适合多个条件判断，比嵌套IF()可读性更好
+
+**参数说明**:
+- 条件1:判断的第一个条件
+- 值1:条件1结果为TRUE时返回的值
+- 条件2:条件1结果为FALSE时，继续判断的条件
+- 值2:条件2结果为TRUE时返回的值
+
+**示例**:
+```
+IFS([分数]>=80,"优秀",[分数]>=70,"良好",[分数]>=60,"及格",TRUE,"不及格")
+IFS([分数] >= 90, "优秀", [分数] >= 70, "良好", [分数] >= 60, "及格", TRUE, "不及格")
+```
+
+---
+
+## ISBLANK - 空值判断
+
+**表达式**: `ISBLANK(值)`
+
+**函数说明**: 检测参数值是否为空，为空则返回逻辑值 TRUE；否则，返回 FALSE。
+
+**参数说明**: 值： 必需，检测值是否为空的字段
+
+**示例**:
+```
+ISBLANK([名称]) => TRUE
+ISBLANK("")=>TRUE
+IF(ISBLANK([手机号]), "未填写", "已填写")
+```
+
+---
+
+## ISERROR - 错误判断
+
+**表达式**: `ISERROR(值)`
+
+**函数说明**: 检测参数值是否为错误值，错误值则返回逻辑值 TRUE；否则，返回 FALSE。
+
+**参数说明**: 值： 必需，检测值是否为错误的字段
+
+**示例**:
+```
+ISERROR(2/0) => TRUE
+IF(ISERROR([金额] / [数量]), "计算错误", [金额] / [数量])
+```
+
+---
+
+## ISNULL - 空值判断
+
+**表达式**: `ISNULL(值)`
+
+**函数说明**: 检测参数值内容是否为空，为空则返回逻辑值 TRUE；否则，返回 FALSE。空字符串不为空
+
+**参数说明**: 值： 必需，检测值是否为空的字段
+
+**示例**:
+```
+// 页面上
+ISNULL([数据表.文本]) => FALSE   // 该字段有记录且非空
+ISNULL([页面.输入框]) => FALSE  // 控件有值
+
+// 当前行
+ISNULL([文本]) => TRUE             // 当前行该字段为空
+ISNULL("") => FALSE              // 空字符串 "" 在 ISNULL 语义下不视为空（与 ISBLANK 不同）
+```
+
+> ISNULL 与 ISBLANK 区别：ISBLANK 认为 `""` 是空，返回 TRUE；ISNULL 不认为 `""` 是空，返回 FALSE。
+
+---
+
+## NOT - 逻辑非
+
+**表达式**: `NOT(逻辑表达式)`
+
+**函数说明**: 对参数的逻辑值取反。如果逻辑为 FALSE，NOT 将返回 TRUE；如果逻辑为 TRUE，NOT 将返回 FALSE。
+
+**参数说明**: 逻辑表达式：必需，计算结果为 TRUE 或 FALSE 的任何值或表达式
+
+**示例**:
+```
+NOT(92>100) => TRUE
+NOT([已完成])
+```
+
+---
+
+## OR - 逻辑或
+
+**表达式**: `OR(逻辑表达式1, [逻辑表达式2, ...])`
+
+**函数说明**: 使用 OR 函数，它是一个逻辑函数，用于确定测试中的所有条件是否均为 FALSE。所有参数的计算结果为 FALSE 时，OR 函数返回 FALSE；只要有一个参数的计算结果为 TRUE，即返回 TRUE。
+
+[警告] **不能使用 || 运算符**：公式系统不支持 JavaScript 的 || 运算符，必须使用 OR() 函数
+
+**参数说明**: 逻辑表达式1：必填，一个表达式或对包含表达式字段的引用，代表某种逻辑值，即 TRUE 或 FALSE。
+
+**示例**:
+```
+[正例] OR(2>1, 92<100)
+[正例] OR([状态]="高优先级", [状态]="紧急")
+
+[反例] 2>1 || 92<100  // 不支持 ||
+[反例] [状态]="高优先级" || [状态]="紧急"  // 不支持 ||
+```
+
+---
+
+## SWITCH - 条件匹配
+
+**表达式**: `SWITCH(表达式, 值1, 结果1, [值2, ...], [结果2, ...])`
+
+**函数说明**: 通过和表达式结果比较，按照匹配结果返回对应的值，如果不匹配，则返回可选默认值
+
+**参数说明**:
+- 表达式：输出结果的值，可以是一个字段
+- 值1:和表达式结果进行匹配的值
+- 结果1:值1和表达式结果匹配后返回的值
+- 值2:值1和表达式结果不匹配的时候，则和值2 进行匹配
+
+**示例**:
+```
+SWITCH([日期],1,"周日",2,"周一","不匹配") => 周一 //如果WEEKDAY([日期])的结果为1，则返回周日，结果等于2则返回周一，否则返回"不匹配"。
+SWITCH([状态], "1", "待处理", "2", "进行中", "3", "已完成", "未知")
+```
+
+---
+
+## TRUE - 真值
+
+**表达式**: `TRUE()`
+
+**函数说明**: 返回逻辑值TRUE。
+
+**参数说明**: TRUE函数语法没有参数
+
+**示例**:
+```
+TRUE() => TRUE
+IF([已完成] = TRUE, "完成", "进行中")
+```