@rezti/dsh-rez-suite 0.1.49 → 0.1.51

package/templates/shared/wecomcli-smartpage/references/formula/arraylist.md

@@ -0,0 +1,369 @@
+# 数组/列表公式函数(`AT`, `CHOOSE`, `CONTAINS`, `CONTAINSALL`, `CONTAINSONLY`, `FILTER`, `FIRST`, `LAST`, `LIST`, `LISTCOMBINE`, `LISTJOIN`, `LOOKUP`, `UNIQUE`)
+
+> 用于对数据进行筛选、过滤、提取、合并、去重等操作，适用于数据统计、关联查询、列表处理等场景。
+
+---
+
+## AT - 获取列表指定位置元素
+
+**表达式**: `列表.AT(位置)`
+
+**函数说明**: 返回列表里面第N个位置的元素
+
+**参数说明**:
+
+- 列表：可以是数据表.字段、或一系列值
+- 位置：要返回的值的位置（从 1 开始）。正数，表示从左往右第 N 个值；负数，表示从右往左第 N 个值。
+
+**示例**:
+
+```
+LIST(1,2,3,4).AT(2)  =>  2  //返回列表 [1,2,3,4] 中的从左往右第2个元素
+LIST("智","能","表","格").AT(-2) =>  表 //返回列表  ["智","能","表","格"] 中从右往左第2个元素
+```
+
+---
+
+## CHOOSE - 根据索引选择
+
+**表达式**: `CHOOSE(索引号,选择1,[选择2],...)`
+
+**函数说明**: 根据索引号从选择列表中返回对应需要执行的值或操作
+
+**参数说明**:
+
+- 索引号：必需，指定选择列表中某个选择对应的位置。索引号必须是1到254之间的数字
+- 选择1：必需，参数可以是一个字段，也可以是列表，也可以是数据表.字段
+- 选择2：可选，其他可选择的值，最多可以支持254个选择
+
+**示例**:
+
+```
+CHOOSE(3,"Hello"," ","World") => World
+```
+
+---
+
+## CONTAINS - 包含任一判断
+
+**表达式**: `查找范围.CONTAINS([值1,值2,...])`
+
+**函数说明**: 判断查找范围中是否包含任一要查找的内容
+
+**参数说明**:
+
+- 查找范围：必填，查找的范围，可以是多个值也可以是一个值
+- 值：要查找的内容，可以是多个值也可以是一个值
+
+**限制**:
+
+- CONTAINS只支持同类型比较。
+
+通过文本筛选人员字段：
+[反例]: [表.人员字段].FILTER([Each].CONTAINS("zhangsan")).FIRST()
+[正例]: [表.人员字段].FILTER([Each].CONTAINTEXT("zhangsan")).FIRST() // CONTAINTEXT 支持人员通过文本形式筛选
+[正例]: [表.人员字段].FILTER([Each].CONTAINS(USER())).FIRST() // USER() 返回的对象是user类型的，支持
+
+**示例**:
+
+```
+[项目管理表.项目成员].CONTAINS([项目负责人]) // 判断 [项目管理表] 里面的 [项目成员] 整列内容中是否包含项目负责人中任意一个
+[多选].CONTAINS("选项1","选项2") // 判断 [多选] 字段中是否包含"选项1"、"选项2"中的任意一个
+LIST(1,2,3,4).CONTAINS(2,5) =>  TRUE   //在列表(1,2,3,4)中找是否包含2、5任意一个
+LIST(1,2,3,4).CONTAINS(5,6,7) =>  FALSE  //在列表(1,2,3,4)中找是否包含5、6、7任意一个
+```
+
+---
+
+## CONTAINSALL - 包含全部判断
+
+**表达式**: `查找范围.CONTAINSALL([值1,值2,...])`
+
+**函数说明**: 判断查找范围是否包含所有查找内容
+
+**参数说明**:
+
+- 查找范围：必填，查找的范围
+- 值：要查找的内容
+
+**示例**:
+
+```
+[项目成员].CONTAINSALL([项目负责人]) // 判断当前表里面的 [项目成员]字段中包含全部[项目负责人]
+[多选].CONTAINSALL("选项1","选项2") // 判断[多选]字段中"选项1"和"选项2"是否都包含
+LIST(1,2,3,4).CONTAINSALL(1,2)    =>  TRUE  // 1,2,3,4是否1,2都包含
+LIST(1,2,3,4).CONTAINSALL(1,2,5)  =>  FALSE  // 1,2,3,4是否1,2,5都包含
+```
+
+---
+
+## CONTAINSONLY - 仅包含判断
+
+**表达式**: `查找范围.CONTAINSONLY([值1,值2,...])`
+
+**函数说明**: 判断查找范围是否仅包含所有查找内容，不要求顺序一致
+
+**参数说明**:
+
+- 查找范围：必填，查找的范围
+- 值：要查找的内容
+
+**示例**:
+
+```
+[项目成员].CONTAINSONLY([项目负责人]) // 判断当前表里面的 [项目成员] 字段是否只包含[项目负责人]
+[多选].CONTAINSONLY("选项1","选项2") // 判断 [多选] 字段中是否只包含"选项1"和"选项2"
+LIST(1,2,3,4).CONTAINSONLY(1,2)    =>  FALSE  // 1,2,3,4是否只包含1,2
+LIST(1,2,3,4).CONTAINSONLY(1,2,4,3)  => TRUE  // 1,2,3,4是否只包含1,2,4,3
+```
+
+---
+
+## FILTER - 筛选函数
+
+[警告] **必须使用 [Each] 引用**：在筛选条件中引用字段时，必须写成 `[Each].[字段名]`
+
+**表达式**: `数据范围.FILTER(筛选条件)`
+
+**函数说明**: 从数据范围中筛选出符合筛选条件的内容，需要通过 `[Each]` 进行逐一判断
+
+**参数说明**:
+- 数据范围：参与条件筛选的范围
+- 筛选条件：取数据范围的值进行条件筛选，返回符合筛选条件的值
+
+**示例**:
+
+```
+[正例] 正确写法：
+[任务管理表].FILTER([Each].[启动时间]<TODAY()).[项目名称] =>项目名称1,项目名称3 // 找出 [启动时间] 今天之前的项目有哪些
+LIST(1,2,3,4).FILTER([Each]>2)  =>  3,4  //查找列表 [1,2,3,4] 中大于2的值有为 3,4
+
+[反例] 错误写法（会解析失败）：
+[任务管理表].FILTER([启动时间]<TODAY())  // 缺少 [Each]
+```
+
+### 基本筛选
+
+[表名].FILTER([Each].[字段名] = 值).[字段]
+
+- `[Each]` 表示当前遍历的行，在FILTER中取*表名*对应的字段，*必须*用到Each。
+- 数据表中引用整表时，`FILTER`函数需要指定引用字段。
+
+[反例]写法：
+[表名].FILTER([Each].[字段名] = 值) // 未指定字段
+[正例]写法：
+[表名].FILTER([Each].[字段名] = 值).[字段]
+
+**示例**：
+
+```
+// 筛选状态为"完成"的记录
+[任务表].FILTER([Each].[状态] = "完成").[任务名称]
+
+// 筛选金额大于1000的订单
+[订单表].FILTER([Each].[金额] > 1000).[订单名称]
+
+// 筛选日期在今天之后的任务
+[任务表].FILTER([Each].[截止日期] > TODAY()).[任务名称]
+
+// 引用其他表字段，与自己比较
+// 统计表: 统计年份、成单金额汇总
+// 成单表: 日期、成单金额
+[成单表].FILTER(YEAR([Each].[日期]) = [统计年份]).[成单金额].SUM()
+```
+
+### 筛选后统计
+
+[表名].FILTER([Each].[字段A] = 值).[字段B].SUM()
+
+**示例**：
+
+```
+// 统计已完成任务的总金额
+[任务表].FILTER([Each].[状态] = "完成").[金额].SUM()
+
+// 统计优先级为高的任务数量
+[任务表].FILTER([Each].[优先级] = "高").[任务名称].COUNTA()
+```
+
+### 多条件筛选（AND）
+
+[表名].FILTER(AND([Each].[字段A] = 值1, [Each].[字段B] > 值2))
+
+**示例**：
+
+```
+// 筛选已完成且金额大于1000的任务
+[任务表].FILTER(AND([Each].[状态] = "完成", [Each].[金额] > 1000)).[金额].SUM()
+```
+
+### 多条件筛选（OR）
+
+[表名].FILTER(OR([Each].[字段A] = 值1, [Each].[字段B] = 值2))
+
+**示例**：
+
+```
+// 筛选优先级为高或紧急的任务
+[任务表].FILTER(OR([Each].[优先级] = "高", [Each].[优先级] = "紧急"))
+```
+
+### 筛选条件引用当前行字段
+
+[其他表].FILTER([Each].[字段] = [当前表字段])
+
+**示例**：
+
+```
+// 统计另一个表中状态等于本表状态的记录总金额
+[订单表].FILTER([Each].[状态] = [状态]).[金额].SUM()
+```
+
+### 访问关联记录内的字段
+
+可以通过[关联字段]筛选条件。在公式中，关联字段默认代表关联表顺序第一个文本或日期或数字类型列。
+
+**示例**:
+// 学生表字段列表：姓名、年龄、所属班级(引用)
+// 班级表字段列表：班级名、班级学生数量(公式)。
+// 需求：需要统计所有班的学生。
+
+// 班级学生数量(公式)
+[学生表].FILTER([Each].[所属班级] = [班级名]).COUNTA()
+
+---
+
+## FIRST - 首个元素
+
+**表达式**: `列表.FIRST()`
+
+**函数说明**: 返回列表中的第一个元素
+
+**参数说明**: 列表：可以是数据表.字段、或一系列值
+
+**示例**:
+
+```
+LIST(1,2,3).FIRST()  => 1  //返回列表[1,2,3]中的第一个元素
+LIST("智","能","表","格").FIRST()  =>  智  //返回列表 ["智","能","表","格"] 中的第一个元素
+```
+
+---
+
+## LAST - 末尾元素
+
+**表达式**: `列表.LAST()`
+
+**函数说明**: 返回列表中的最后一个元素
+
+**参数说明**: 列表：可以是数据表.字段、或一系列值
+
+**示例**:
+
+```
+LIST(1,2,3).LAST()  => 3  //返回列表[1,2,3]中的最后一个元素
+LIST("智","能","表","格").LAST()  =>  格  //返回列表 ["智","能","表","格"] 中的最后一个元素
+```
+
+---
+
+## LIST - 创建列表
+
+**表达式**: `LIST([值1,值2,...])`
+
+**函数说明**: 返回一个列表
+
+**参数说明**: 值：参与生成列表的内容
+
+**示例**:
+
+```
+LIST([项目负责人],[项目成员]).LISTCOMBINE() => 返回项目总参与人的列表
+LIST("智","能","表","格")  =>  [智,能,表,格] //返回列表 [智,能,表,格]
+```
+
+---
+
+## LISTCOMBINE - 合并列表
+
+**表达式**: `值1.LISTCOMBINE([值2,...])`
+
+**函数说明**: 将多个列表合并为一个列表
+
+**参数说明**: 字段：可以是一个字段，也可以是列表，也可以是数据表.字段
+
+**示例**:
+
+```
+[项目管理表].[项目负责人].LISTCOMBINE([项目管理表].[部门负责人]) // 将项目负责人列表和部门负责人列表合并为一个列表。
+LISTCOMBINE(LIST(1,2,LIST(3,4)),5,6)  =>  [1,2,3,4,5,6] //将嵌套列表 [1,2,[3,4]] 和常量5,6合并返回列表 [1,2,3,4,5,6]
+```
+
+---
+
+## LISTJOIN - 列表拼接
+
+**表达式**: `列表.LISTJOIN([分隔符])`
+
+**函数说明**: 用分隔符拼接列表中的多个值
+
+**参数说明**:
+
+- 列表:必填，可以是数据表.字段、或一系列值
+- 分隔符:用于拼接列表的值。自定义拼接符，不填写则默认是英文逗号
+
+**示例**:
+
+```
+LIST(1,2,3,4).LISTJOIN()  =>   1,2,3,4 //将列表用 "，" 拼接返回文本
+LIST("智","能","表","格").LISTJOIN("-")   =>  智-能-表-格 //将列表用"-" 拼接返回文本
+```
+
+---
+
+## LOOKUP - 查找
+
+**表达式**: `LOOKUP(查找的值，匹配的值，返回的字段，[查找模式])`
+
+**函数说明**: 在列表中查找符合条件的值
+
+**参数说明**:
+
+- 查找的值：要查找的值，当前表的字段，也可以手动输入
+- 匹配的值：用来和查找值进行匹配的值，其他表的字段
+- 返回的字段：条件匹配后返回结果的字段 ，和匹配的值是同一个表
+- 查找模式：字段多选的时候，1代表拆分选项，0代表不拆分
+
+**示例**:
+
+```
+LOOKUP([项目负责人],[人员信息表.姓名],[人员信息表.所属部门],1)=>部门1 //根据项目负责人 = 姓名，返回人员信息表中对应姓名的所属部门。
+```
+
+---
+
+## UNIQUE - 去重
+
+**表达式**: `值1.UNIQUE([值2,...])`
+
+**函数说明**: 对列表中的数据进行去重
+
+**参数说明**: 值:可以是多个值，也可以是数据表.字段，也可以是多个字段
+
+**示例**:
+
+```
+[经营分析].[门店店员].UNIQUE()  => 返回去重后的门店店员
+[经营分析].[门店店员].UNIQUE().COUNTA()  => 对店员列表去重后计数=店员人数
+LIST(1,2,2,3,1).UNIQUE()  =>  [1,2,3]  //对列表 [1,2,2,3,1] 去重返回列表 [1,2,3]
+```
+
+**简化写法**：
+[表名].[字段名].UNIQUE()
+
+**示例**：
+
+```
+// 统计不重复的部门数量
+[员工表.部门].UNIQUE().COUNTA()
+```

package/templates/shared/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([入职日期])
+```