amis-formula 3.1.0 → 3.2.0

package/esm/doc.js

@@ -1,5 +1,5 @@
 /**
- * amis-formula v3.1.0
+ * amis-formula v3.2.0
  * Copyright 2021-2023 fex
  */
 
@@ -9,13 +9,13 @@
 var doc = [
     {
         name: "IF",
-        description: "示例：IF(A, B, C)\n\n如果满足条件A，则返回B，否则返回C，支持多层嵌套IF函数。\n\n也可以用表达式如：A ? B : C",
+        description: "如果满足条件condition，则返回consequent，否则返回alternate，支持多层嵌套IF函数。\n\n等价于直接用JS表达式如：condition ? consequent : alternate。",
         example: "IF(condition, consequent, alternate)",
         params: [
             {
                 type: "expression",
                 name: "condition",
-                description: "条件表达式."
+                description: "条件表达式。例如：语文成绩>80"
             },
             {
                 type: "any",
@@ -36,13 +36,13 @@ var doc = [
     },
     {
         name: "AND",
-        description: "条件全部符合，返回 true，否则返回 false\n\n示例：AND(语文成绩>80, 数学成绩>80)\n\n语文成绩和数学成绩都大于 80，则返回 true，否则返回 false\n\n也可以直接用表达式如：语文成绩>80 && 数学成绩>80",
+        description: "条件全部符合，返回 true，否则返回 false。\n\n示例：AND(语文成绩>80, 数学成绩>80)，\n\n语文成绩和数学成绩都大于 80，则返回 true，否则返回 false，\n\n等价于直接用JS表达式如：语文成绩>80 && 数学成绩>80。",
         example: "AND(expression1, expression2, ...expressionN)",
         params: [
             {
                 type: "...expression",
                 name: "conditions",
-                description: "条件表达式."
+                description: "条件表达式，多个用逗号隔开。例如：语文成绩>80, 数学成绩>80"
             }
         ],
         returns: {
@@ -53,13 +53,13 @@ var doc = [
     },
     {
         name: "OR",
-        description: "条件任意一个满足条件，返回 true，否则返回 false\n\n示例：OR(语文成绩>80, 数学成绩>80)\n\n语文成绩和数学成绩任意一个大于 80，则返回 true，否则返回 false\n\n也可以直接用表达式如：语文成绩>80 || 数学成绩>80",
+        description: "条件任意一个满足条件，返回 true，否则返回 false。\n\n示例：OR(语文成绩>80, 数学成绩>80)，\n\n语文成绩和数学成绩任意一个大于 80，则返回 true，否则返回 false，\n\n等价于直接用JS表达式如：语文成绩>80 || 数学成绩>80。",
         example: "OR(expression1, expression2, ...expressionN)",
         params: [
             {
                 type: "...expression",
                 name: "conditions",
-                description: "条件表达式."
+                description: "条件表达式，多个用逗号隔开。例如：语文成绩>80, 数学成绩>80"
             }
         ],
         returns: {
@@ -70,18 +70,13 @@ var doc = [
     },
     {
         name: "XOR",
-        description: "异或处理，多个表达式组中存在奇数个真时认为真。",
-        example: "XOR(condition1, condition2)",
+        description: "异或处理，多个表达式组中存在奇数个真时认为真。\n\n示例：XOR(语文成绩 > 80, 数学成绩 > 80, 英语成绩 > 80)\n\n三门成绩中有一门或者三门大于 80，则返回 true，否则返回 false。",
+        example: "XOR(condition1, condition2, ...expressionN)",
         params: [
             {
-                type: "expression",
-                name: "condition1",
-                description: "条件表达式1"
-            },
-            {
-                type: "expression",
-                name: "condition2",
-                description: "条件表达式2"
+                type: "...expression",
+                name: "condition",
+                description: "条件表达式，多个用逗号隔开。例如：语文成绩>80, 数学成绩>80"
             }
         ],
         returns: {
@@ -92,13 +87,18 @@ var doc = [
     },
     {
         name: "IFS",
-        description: "判断函数集合，相当于多个 else if 合并成一个。\n\n示例：IFS(语文成绩 > 80, \"优秀\", 语文成绩 > 60, \"良\", \"继续努力\")\n\n如果语文成绩大于 80，则返回优秀，否则判断大于 60 分，则返回良，否则返回继续努力。",
+        description: "判断函数集合，相当于多个 else if 合并成一个。\n\n示例：IFS(语文成绩 > 80, \"优秀\", 语文成绩 > 60, \"良\", \"继续努力\")，\n\n如果语文成绩大于 80，则返回优秀，否则判断大于 60 分，则返回良，否则返回继续努力。",
         example: "IFS(condition1, result1, condition2, result2,...conditionN, resultN)",
         params: [
+            {
+                type: "...expression",
+                name: "condition",
+                description: "条件表达式"
+            },
             {
                 type: "...any",
-                name: "args",
-                description: "条件，返回值集合"
+                name: "result",
+                description: "返回值"
             }
         ],
         returns: {
@@ -109,7 +109,7 @@ var doc = [
     },
     {
         name: "ABS",
-        description: "返回传入数字的绝对值",
+        description: "返回传入数字的绝对值。",
         example: "ABS(num)",
         params: [
             {
@@ -126,7 +126,7 @@ var doc = [
     },
     {
         name: "MAX",
-        description: "获取最大值，如果只有一个参数且是数组，则计算这个数组内的值",
+        description: "获取最大值，如果只有一个参数且是数组，则计算这个数组内的值。",
         example: "MAX(num1, num2, ...numN)",
         params: [
             {
@@ -143,7 +143,7 @@ var doc = [
     },
     {
         name: "MIN",
-        description: "获取最小值，如果只有一个参数且是数组，则计算这个数组内的值",
+        description: "获取最小值，如果只有一个参数且是数组，则计算这个数组内的值。",
         example: "MIN(num1, num2, ...numN)",
         params: [
             {
@@ -160,7 +160,7 @@ var doc = [
     },
     {
         name: "SUM",
-        description: "求和，如果只有一个参数且是数组，则计算这个数组内的值",
+        description: "求和，如果只有一个参数且是数组，则计算这个数组内的值。",
         example: "SUM(num1, num2, ...numN)",
         params: [
             {
@@ -177,7 +177,7 @@ var doc = [
     },
     {
         name: "INT",
-        description: "将数值向下取整为最接近的整数",
+        description: "将数值向下取整为最接近的整数。",
         example: "INT(num)",
         params: [
             {
@@ -194,7 +194,7 @@ var doc = [
     },
     {
         name: "MOD",
-        description: "返回两数相除的余数，参数 number 是被除数，divisor 是除数",
+        description: "返回两数相除的余数，参数 number 是被除数，divisor 是除数。",
         example: "MOD(num, divisor)",
         params: [
             {
@@ -216,7 +216,7 @@ var doc = [
     },
     {
         name: "PI",
-        description: "圆周率 3.1415...",
+        description: "圆周率 3.1415...。",
         example: "PI()",
         params: [],
         returns: {
@@ -238,7 +238,7 @@ var doc = [
             {
                 type: "number",
                 name: "numDigits",
-                description: "小数位数"
+                description: "小数位数，默认为2"
             }
         ],
         returns: {
@@ -260,7 +260,7 @@ var doc = [
             {
                 type: "number",
                 name: "numDigits",
-                description: "小数位数"
+                description: "小数位数，默认为2"
             }
         ],
         returns: {
@@ -282,7 +282,7 @@ var doc = [
             {
                 type: "number",
                 name: "numDigits",
-                description: "小数位数"
+                description: "小数位数，默认为2"
             }
         ],
         returns: {
@@ -310,7 +310,7 @@ var doc = [
     },
     {
         name: "AVG",
-        description: "返回所有参数的平均值，如果只有一个参数且是数组，则计算这个数组内的值",
+        description: "返回所有参数的平均值，如果只有一个参数且是数组，则计算这个数组内的值。",
         example: "AVG(num1, num2, ...numN)",
         params: [
             {
@@ -327,7 +327,7 @@ var doc = [
     },
     {
         name: "DEVSQ",
-        description: "返回数据点与数据均值点之差（数据偏差）的平方和，如果只有一个参数且是数组，则计算这个数组内的值",
+        description: "返回数据点与数据均值点之差（数据偏差）的平方和，如果只有一个参数且是数组，则计算这个数组内的值。",
         example: "DEVSQ(num1, num2, ...numN)",
         params: [
             {
@@ -344,7 +344,7 @@ var doc = [
     },
     {
         name: "AVEDEV",
-        description: "数据点到其算术平均值的绝对偏差的平均值",
+        description: "数据点到其算术平均值的绝对偏差的平均值。",
         example: "AVEDEV(num1, num2, ...numN)",
         params: [
             {
@@ -361,7 +361,7 @@ var doc = [
     },
     {
         name: "HARMEAN",
-        description: "数据点的调和平均值，如果只有一个参数且是数组，则计算这个数组内的值",
+        description: "数据点的调和平均值，如果只有一个参数且是数组，则计算这个数组内的值。",
         example: "HARMEAN(num1, num2, ...numN)",
         params: [
             {
@@ -378,7 +378,7 @@ var doc = [
     },
     {
         name: "LARGE",
-        description: "数据集中第 k 个最大值",
+        description: "数据集中第 k 个最大值。",
         example: "LARGE(array, k)",
         params: [
             {
@@ -400,7 +400,7 @@ var doc = [
     },
     {
         name: "UPPERMONEY",
-        description: "将数值转为中文大写金额",
+        description: "将数值转为中文大写金额。",
         example: "UPPERMONEY(num)",
         params: [
             {
@@ -417,7 +417,7 @@ var doc = [
     },
     {
         name: "RAND",
-        description: "返回大于等于 0 且小于 1 的均匀分布随机实数。每一次触发计算都会变化。\n\n示例：`RAND()*100`\n\n返回 0-100 之间的随机数",
+        description: "返回大于等于 0 且小于 1 的均匀分布随机实数。每一次触发计算都会变化。\n\n示例：`RAND()*100`，\n\n返回 0-100 之间的随机数。",
         example: "RAND()",
         params: [],
         returns: {
@@ -428,7 +428,7 @@ var doc = [
     },
     {
         name: "LAST",
-        description: "取数据最后一个",
+        description: "取数据最后一个。",
         example: "LAST(array)",
         params: [
             {
@@ -489,7 +489,7 @@ var doc = [
     },
     {
         name: "LEN",
-        description: "计算文本的长度",
+        description: "计算文本的长度。",
         example: "LEN(text)",
         params: [
             {
@@ -506,7 +506,7 @@ var doc = [
     },
     {
         name: "LENGTH",
-        description: "计算文本集合中所有文本的长度",
+        description: "计算文本集合中所有文本的长度。",
         example: "LENGTH(textArr)",
         params: [
             {
@@ -523,7 +523,7 @@ var doc = [
     },
     {
         name: "ISEMPTY",
-        description: "判断文本是否为空",
+        description: "判断文本是否为空。",
         example: "ISEMPTY(text)",
         params: [
             {
@@ -540,7 +540,7 @@ var doc = [
     },
     {
         name: "CONCATENATE",
-        description: "将多个传入值连接成文本",
+        description: "将多个传入值连接成文本。",
         example: "CONCATENATE(text1, text2, ...textN)",
         params: [
             {
@@ -557,7 +557,7 @@ var doc = [
     },
     {
         name: "CHAR",
-        description: "返回计算机字符集的数字代码所对应的字符。\n\n`CHAR(97)` 等价于 \"a\"",
+        description: "返回计算机字符集的数字代码所对应的字符。\n\n示例：`CHAR(97)` 等价于 \"a\"。",
         example: "CHAR(code)",
         params: [
             {
@@ -574,7 +574,7 @@ var doc = [
     },
     {
         name: "LOWER",
-        description: "将传入文本转成小写",
+        description: "将传入文本转成小写。",
         example: "LOWER(text)",
         params: [
             {
@@ -591,7 +591,7 @@ var doc = [
     },
     {
         name: "UPPER",
-        description: "将传入文本转成大写",
+        description: "将传入文本转成大写。",
         example: "UPPER(text)",
         params: [
             {
@@ -608,7 +608,7 @@ var doc = [
     },
     {
         name: "UPPERFIRST",
-        description: "将传入文本首字母转成大写",
+        description: "将传入文本首字母转成大写。",
         example: "UPPERFIRST(text)",
         params: [
             {
@@ -625,7 +625,7 @@ var doc = [
     },
     {
         name: "PADSTART",
-        description: "向前补齐文本长度\n\n示例 `PADSTART(\"6\", 2, \"0\")`\n\n返回 `06`",
+        description: "向前补齐文本长度。\n\n示例 `PADSTART(\"6\", 2, \"0\")`，\n\n返回 `06`。",
         example: "PADSTART(text)",
         params: [
             {
@@ -652,7 +652,7 @@ var doc = [
     },
     {
         name: "CAPITALIZE",
-        description: "将文本转成标题\n\n示例 `CAPITALIZE(\"star\")`\n\n返回 `Star`",
+        description: "将文本转成标题。\n\n示例 `CAPITALIZE(\"star\")`，\n\n返回 `Star`。",
         example: "CAPITALIZE(text)",
         params: [
             {
@@ -669,7 +669,7 @@ var doc = [
     },
     {
         name: "ESCAPE",
-        description: "对文本进行 HTML 转义\n\n示例 `ESCAPE(\"<star>&\")`\n\n返回 `&lt;start&gt;&amp;`",
+        description: "对文本进行 HTML 转义。\n\n示例 `ESCAPE(\"<star>&\")`，\n\n返回 `&lt;start&gt;&amp;`。",
         example: "ESCAPE(text)",
         params: [
             {
@@ -686,7 +686,7 @@ var doc = [
     },
     {
         name: "TRUNCATE",
-        description: "对文本长度进行截断\n\n示例 `TRUNCATE(\"amis.baidu.com\", 6)`\n\n返回 `amis...`",
+        description: "对文本长度进行截断。\n\n示例 `TRUNCATE(\"amis.baidu.com\", 6)`，\n\n返回 `amis...`。",
         example: "TRUNCATE(text, 6)",
         params: [
             {
@@ -708,7 +708,7 @@ var doc = [
     },
     {
         name: "BEFORELAST",
-        description: "取在某个分隔符之前的所有字符串",
+        description: "取在某个分隔符之前的所有字符串。",
         example: "BEFORELAST(text, '.')",
         params: [
             {
@@ -730,7 +730,7 @@ var doc = [
     },
     {
         name: "SPLIT",
-        description: "将文本根据指定片段分割成数组\n\n示例：`SPLIT(\"a,b,c\", \",\")`\n\n返回 `[\"a\", \"b\", \"c\"]`",
+        description: "将文本根据指定片段分割成数组。\n\n示例：`SPLIT(\"a,b,c\", \",\")`，\n\n返回 `[\"a\", \"b\", \"c\"]`。",
         example: "SPLIT(text, ',')",
         params: [
             {
@@ -752,7 +752,7 @@ var doc = [
     },
     {
         name: "TRIM",
-        description: "将文本去除前后空格",
+        description: "将文本去除前后空格。",
         example: "TRIM(text)",
         params: [
             {
@@ -769,7 +769,7 @@ var doc = [
     },
     {
         name: "STRIPTAG",
-        description: "去除文本中的 HTML 标签\n\n示例：`STRIPTAG(\"<b>amis</b>\")`\n\n返回：`amis`",
+        description: "去除文本中的 HTML 标签。\n\n示例：`STRIPTAG(\"<b>amis</b>\")`，\n\n返回：`amis`。",
         example: "STRIPTAG(text)",
         params: [
             {
@@ -786,7 +786,7 @@ var doc = [
     },
     {
         name: "LINEBREAK",
-        description: "将字符串中的换行转成 HTML `<br>`，用于简单换行的场景\n\n示例：`LINEBREAK(\"\\n\")`\n\n返回：`<br/>`",
+        description: "将字符串中的换行转成 HTML `<br>`，用于简单换行的场景。\n\n示例：`LINEBREAK(\"\\n\")`，\n\n返回：`<br/>`。",
         example: "LINEBREAK(text)",
         params: [
             {
@@ -803,7 +803,7 @@ var doc = [
     },
     {
         name: "STARTSWITH",
-        description: "判断字符串(text)是否以特定字符串(startString)开始，是则返回 True，否则返回 False",
+        description: "判断字符串(text)是否以特定字符串(startString)开始，是则返回 true，否则返回 false。",
         example: "STARTSWITH(text, '片段')",
         params: [
             {
@@ -825,7 +825,7 @@ var doc = [
     },
     {
         name: "ENDSWITH",
-        description: "判断字符串(text)是否以特定字符串(endString)结束，是则返回 True，否则返回 False",
+        description: "判断字符串(text)是否以特定字符串(endString)结束，是则返回 true，否则返回 false。",
         example: "ENDSWITH(text, '片段')",
         params: [
             {
@@ -847,7 +847,7 @@ var doc = [
     },
     {
         name: "CONTAINS",
-        description: "判断参数 1 中的文本是否包含参数 2 中的文本。",
+        description: "判断参数 1 中的文本是否包含参数 2 中的文本，是则返回 true，否则返回 false。",
         example: "CONTAINS(text, searchText)",
         params: [
             {
@@ -896,7 +896,7 @@ var doc = [
     },
     {
         name: "SEARCH",
-        description: "对文本进行搜索，返回命中的位置",
+        description: "对文本进行搜索，返回命中的位置。",
         example: "SEARCH(text, search, 0)",
         params: [
             {
@@ -923,7 +923,7 @@ var doc = [
     },
     {
         name: "MID",
-        description: "返回文本字符串中从指定位置开始的特定数目的字符",
+        description: "返回文本字符串中从指定位置开始的特定数目的字符。",
         example: "MID(text, from, len)",
         params: [
             {
@@ -950,7 +950,7 @@ var doc = [
     },
     {
         name: "BASENAME",
-        description: "返回路径中的文件名\n\n示例：`/home/amis/a.json`\n\n返回：a.json`",
+        description: "返回路径中的文件名。\n\n示例：`/home/amis/a.json`，\n\n返回：a.json`。",
         example: "BASENAME(text)",
         params: [
             {
@@ -967,7 +967,7 @@ var doc = [
     },
     {
         name: "DATE",
-        description: "创建日期对象，可以通过特定格式的字符串，或者数值。\n\n需要注意的是，其中月份的数值是从0开始的，也就是说，\n如果是12月份，你应该传入数值11。",
+        description: "创建日期对象，可以通过特定格式的字符串，或者数值。\n\n需要注意的是，其中月份的数值是从0开始的，\n即如果是12月份，你应该传入数值11。",
         example: "DATE('2021-12-06 08:20:00')",
         params: [],
         returns: {
@@ -978,8 +978,8 @@ var doc = [
     },
     {
         name: "TIMESTAMP",
-        description: "返回时间的时间戳",
-        example: "TIMESTAMP(date, 'x')",
+        description: "返回时间的时间戳。",
+        example: "TIMESTAMP(date[, format = \"X\"])",
         params: [
             {
                 type: "date",
@@ -1000,7 +1000,7 @@ var doc = [
     },
     {
         name: "TODAY",
-        description: "返回今天的日期",
+        description: "返回今天的日期。",
         example: "TODAY()",
         params: [],
         returns: {
@@ -1022,7 +1022,7 @@ var doc = [
     },
     {
         name: "WEEKDAY",
-        description: "获取日期的星期几，\n\n示例：\n\nWEEKDAY('2023-02-27') 得到 1",
+        description: "获取日期的星期几。\n\n示例\n\nWEEKDAY('2023-02-27') 得到 1。",
         example: "WEEKDAY(date)",
         params: [
             {
@@ -1044,7 +1044,7 @@ var doc = [
     },
     {
         name: "WEEK",
-        description: "获取年份的星期，即第几周\n\n示例：\n\nWEEK('2023-03-05') 得到 10",
+        description: "获取年份的星期，即第几周。\n\n示例\n\nWEEK('2023-03-05') 得到 10。",
         example: "WEEK(date)",
         params: [
             {
@@ -1066,7 +1066,7 @@ var doc = [
     },
     {
         name: "DATETOSTR",
-        description: "对日期、日期字符串、时间戳进行格式化\n\n示例：\n\nDATETOSTR('12/25/2022', 'YYYY-MM-DD') 得到 '2022.12.25'\nDATETOSTR(1676563200, 'YYYY.MM.DD') 得到 '2023.02.17'\nDATETOSTR(1676563200000, 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.17 12:00:00'\nDATETOSTR(DATE('2021-12-21'), 'YYYY.MM.DD hh:mm:ss') 得到 '2021.12.21 08:00:00'",
+        description: "对日期、日期字符串、时间戳进行格式化。\n\n示例\n\nDATETOSTR('12/25/2022', 'YYYY-MM-DD') 得到 '2022.12.25'，\nDATETOSTR(1676563200, 'YYYY.MM.DD') 得到 '2023.02.17'，\nDATETOSTR(1676563200000, 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.17 12:00:00'，\nDATETOSTR(DATE('2021-12-21'), 'YYYY.MM.DD hh:mm:ss') 得到 '2021.12.21 08:00:00'。",
         example: "DATETOSTR(date, 'YYYY-MM-DD')",
         params: [
             {
@@ -1088,7 +1088,7 @@ var doc = [
     },
     {
         name: "DATERANGESPLIT",
-        description: "获取日期范围字符串中的开始时间、结束时间\n\n示例：\n\nDATERANGESPLIT('1676563200, 1676735999') 得到 [1676563200, 1676735999]\nDATERANGESPLIT('1676563200, 1676735999', undefined , 'YYYY.MM.DD hh:mm:ss') 得到 [2023.02.17 12:00:00, 2023.02.18 11:59:59]\nDATERANGESPLIT('1676563200, 1676735999', 0 , 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.17 12:00:00'\nDATERANGESPLIT('1676563200, 1676735999', 'start' , 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.17 12:00:00'\nDATERANGESPLIT('1676563200, 1676735999', 1 , 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.18 11:59:59'\nDATERANGESPLIT('1676563200, 1676735999', 'end' , 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.18 11:59:59'",
+        description: "获取日期范围字符串中的开始时间、结束时间。\n\n示例：\n\nDATERANGESPLIT('1676563200, 1676735999') 得到 [1676563200, 1676735999]，\nDATERANGESPLIT('1676563200, 1676735999', undefined , 'YYYY.MM.DD hh:mm:ss') 得到 [2023.02.17 12:00:00, 2023.02.18 11:59:59]，\nDATERANGESPLIT('1676563200, 1676735999', 0 , 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.17 12:00:00'，\nDATERANGESPLIT('1676563200, 1676735999', 'start' , 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.17 12:00:00'，\nDATERANGESPLIT('1676563200, 1676735999', 1 , 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.18 11:59:59'，\nDATERANGESPLIT('1676563200, 1676735999', 'end' , 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.18 11:59:59'。",
         example: "DATERANGESPLIT(date, 'YYYY-MM-DD')",
         params: [
             {
@@ -1120,7 +1120,7 @@ var doc = [
     },
     {
         name: "STARTOF",
-        description: "返回日期的指定范围的开端",
+        description: "返回日期的指定范围的开端。",
         example: "STARTOF(date[unit = \"day\"])",
         params: [
             {
@@ -1147,7 +1147,7 @@ var doc = [
     },
     {
         name: "ENDOF",
-        description: "返回日期的指定范围的末尾",
+        description: "返回日期的指定范围的末尾。",
         example: "ENDOF(date[unit = \"day\"])",
         params: [
             {
@@ -1174,7 +1174,7 @@ var doc = [
     },
     {
         name: "YEAR",
-        description: "返回日期的年份",
+        description: "返回日期的年份。",
         example: "YEAR(date)",
         params: [
             {
@@ -1208,7 +1208,7 @@ var doc = [
     },
     {
         name: "DAY",
-        description: "返回日期的天",
+        description: "返回日期的天。",
         example: "DAY(date)",
         params: [
             {
@@ -1225,7 +1225,7 @@ var doc = [
     },
     {
         name: "HOUR",
-        description: "返回日期的小时",
+        description: "返回日期的小时。",
         example: "HOUR(date)",
         params: [
             {
@@ -1242,7 +1242,7 @@ var doc = [
     },
     {
         name: "MINUTE",
-        description: "返回日期的分",
+        description: "返回日期的分。",
         example: "MINUTE(date)",
         params: [
             {
@@ -1259,7 +1259,7 @@ var doc = [
     },
     {
         name: "SECOND",
-        description: "返回日期的秒",
+        description: "返回日期的秒。",
         example: "SECOND(date)",
         params: [
             {
@@ -1276,7 +1276,7 @@ var doc = [
     },
     {
         name: "YEARS",
-        description: "返回两个日期相差多少年",
+        description: "返回两个日期相差多少年。",
         example: "YEARS(endDate, startDate)",
         params: [
             {
@@ -1298,7 +1298,7 @@ var doc = [
     },
     {
         name: "MINUTES",
-        description: "返回两个日期相差多少分钟",
+        description: "返回两个日期相差多少分钟。",
         example: "MINUTES(endDate, startDate)",
         params: [
             {
@@ -1320,7 +1320,7 @@ var doc = [
     },
     {
         name: "DAYS",
-        description: "返回两个日期相差多少天",
+        description: "返回两个日期相差多少天。",
         example: "DAYS(endDate, startDate)",
         params: [
             {
@@ -1342,7 +1342,7 @@ var doc = [
     },
     {
         name: "HOURS",
-        description: "返回两个日期相差多少小时",
+        description: "返回两个日期相差多少小时。",
         example: "HOURS(endDate, startDate)",
         params: [
             {
@@ -1364,7 +1364,7 @@ var doc = [
     },
     {
         name: "DATEMODIFY",
-        description: "修改日期，对日期进行加减天、月份、年等操作\n\n示例：\n\nDATEMODIFY(A, -2, 'month')\n\n对日期 A 进行往前减2月的操作。",
+        description: "修改日期，对日期进行加减天、月份、年等操作。\n\n示例：\n\nDATEMODIFY(A, -2, 'month')，\n\n对日期 A 进行往前减2月的操作。",
         example: "DATEMODIFY(date, 2, 'days')",
         params: [
             {
@@ -1413,7 +1413,7 @@ var doc = [
     },
     {
         name: "ISBEFORE",
-        description: "判断两个日期，是否第一个日期在第二个日期的前面",
+        description: "判断两个日期，是否第一个日期在第二个日期的前面，是则返回 true，否则返回 false。",
         example: "ISBEFORE(a, b)",
         params: [
             {
@@ -1440,7 +1440,7 @@ var doc = [
     },
     {
         name: "ISAFTER",
-        description: "判断两个日期，是否第一个日期在第二个日期的后面",
+        description: "判断两个日期，是否第一个日期在第二个日期的后面，是则返回 true，否则返回 false。",
         example: "ISAFTER(a, b)",
         params: [
             {
@@ -1467,7 +1467,7 @@ var doc = [
     },
     {
         name: "BETWEENRANGE",
-        description: "判断日期是否在指定范围内\n\n示例：BETWEENRANGE('2021/12/6', ['2021/12/5','2021/12/7'])",
+        description: "判断日期是否在指定范围内，是则返回 true，否则返回 false。\n\n示例：BETWEENRANGE('2021/12/6', ['2021/12/5','2021/12/7'])。",
         example: "BETWEENRANGE(date, [start, end])",
         params: [
             {
@@ -1499,7 +1499,7 @@ var doc = [
     },
     {
         name: "ISSAMEORBEFORE",
-        description: "判断两个日期，是否第一个日期在第二个日期的前面或者相等",
+        description: "判断两个日期，是否第一个日期在第二个日期的前面或者相等，是则返回 true，否则返回 false。",
         example: "ISSAMEORBEFORE(a, b)",
         params: [
             {
@@ -1526,7 +1526,7 @@ var doc = [
     },
     {
         name: "ISSAMEORAFTER",
-        description: "判断两个日期，是否第一个日期在第二个日期的后面或者相等",
+        description: "判断两个日期，是否第一个日期在第二个日期的后面或者相等，是则返回 true，否则返回 false。",
         example: "ISSAMEORAFTER(a, b)",
         params: [
             {
@@ -1553,7 +1553,7 @@ var doc = [
     },
     {
         name: "COUNT",
-        description: "返回数组的长度",
+        description: "返回数组的长度。",
         example: "COUNT(arr)",
         params: [
             {
@@ -1614,7 +1614,7 @@ var doc = [
     },
     {
         name: "ARRAYFINDINDEX",
-        description: "数据做数据查找，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。\n找出第二个箭头函数返回为 true 的成员的索引。\n\n示例：\n\nARRAYFINDINDEX([0, 2, false], item => item === 2) 得到 1",
+        description: "数据做数据查找，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。\n找出第二个箭头函数返回为 true 的成员的索引。\n\n示例：\n\nARRAYFINDINDEX([0, 2, false], item => item === 2) 得到 1。",
         example: "ARRAYFINDINDEX(arr, item => item === 2)",
         params: [
             {
@@ -1636,7 +1636,7 @@ var doc = [
     },
     {
         name: "ARRAYFIND",
-        description: "数据做数据查找，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。\n找出第二个箭头函数返回为 true 的成员。\n\n示例：\n\nARRAYFIND([0, 2, false], item => item === 2) 得到 2",
+        description: "数据做数据查找，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。\n找出第二个箭头函数返回为 true 的成员。\n\n示例：\n\nARRAYFIND([0, 2, false], item => item === 2) 得到 2。",
         example: "ARRAYFIND(arr, item => item === 2)",
         params: [
             {
@@ -1658,7 +1658,7 @@ var doc = [
     },
     {
         name: "ARRAYSOME",
-        description: "数据做数据遍历判断，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。\n判断第二个箭头函数是否存在返回为 true 的成员。\n\n示例：\n\nARRAYSOME([0, 2, false], item => item === 2) 得到 true",
+        description: "数据做数据遍历判断，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。\n判断第二个箭头函数是否存在返回为 true 的成员，是则返回 true，否则返回 false。\n\n示例：\n\nARRAYSOME([0, 2, false], item => item === 2) 得到 true。",
         example: "ARRAYSOME(arr, item => item === 2)",
         params: [
             {
@@ -1680,7 +1680,7 @@ var doc = [
     },
     {
         name: "ARRAYEVERY",
-        description: "数据做数据遍历判断，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。\n判断第二个箭头函数返回是否都为 true。\n\n示例：\n\nARRAYEVERY([0, 2, false], item => item === 2) 得到 false",
+        description: "数据做数据遍历判断，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。\n判断第二个箭头函数返回是否都为 true，是则返回 true，否则返回 false。\n\n示例：\n\nARRAYEVERY([0, 2, false], item => item === 2) 得到 false",
         example: "ARRAYEVERY(arr, item => item === 2)",
         params: [
             {
@@ -1702,7 +1702,7 @@ var doc = [
     },
     {
         name: "ARRAYINCLUDES",
-        description: "判断数据中是否存在指定元素\n\n示例：\n\nARRAYINCLUDES([0, 2, false], 2) 得到 true",
+        description: "判断数据中是否存在指定元素。\n\n示例：\n\nARRAYINCLUDES([0, 2, false], 2) 得到 true。",
         example: "ARRAYINCLUDES(arr, 2)",
         params: [
             {
@@ -1724,7 +1724,7 @@ var doc = [
     },
     {
         name: "COMPACT",
-        description: "数组过滤掉 false、null、0 和 \"\"\n\n示例：\n\nCOMPACT([0, 1, false, 2, '', 3]) 得到 [1, 2, 3]",
+        description: "数组过滤掉 false、null、0 和 \"\"。\n\n示例：\n\nCOMPACT([0, 1, false, 2, '', 3]) 得到 [1, 2, 3]。",
         example: "COMPACT(arr)",
         params: [
             {
@@ -1741,7 +1741,7 @@ var doc = [
     },
     {
         name: "JOIN",
-        description: "数组转成字符串\n\n示例：\n\nJOIN(['a', 'b', 'c'], '=') 得到 'a=b=c'",
+        description: "数组转成字符串。\n\n示例：\n\nJOIN(['a', 'b', 'c'], '=') 得到 'a=b=c'。",
         example: "JOIN(arr, string)",
         params: [
             {
@@ -1763,7 +1763,7 @@ var doc = [
     },
     {
         name: "CONCAT",
-        description: "数组合并\n\n示例：\n\nCONCAT(['a', 'b', 'c'], ['1'], ['3']) 得到 ['a', 'b', 'c', '1', '3']",
+        description: "数组合并。\n\n示例：\n\nCONCAT(['a', 'b', 'c'], ['1'], ['3']) 得到 ['a', 'b', 'c', '1', '3']。",
         example: "CONCAT(['a', 'b', 'c'], ['1'], ['3'])",
         params: [
             {
@@ -1780,7 +1780,7 @@ var doc = [
     },
     {
         name: "UNIQ",
-        description: "数组去重，第二个参数「field」，可指定根据该字段去重\n\n示例：\n\nUNIQ([{a: '1'}, {b: '2'}, {a: '1'}]， 'id')",
+        description: "数组去重，第二个参数「field」，可指定根据该字段去重。\n\n示例：\n\nUNIQ([{a: '1'}, {b: '2'}, {a: '1'}]， 'id')。",
         example: "UNIQ([{a: '1'}, {b: '2'}, {a: '1'}], 'x')",
         params: [
             {
@@ -1802,7 +1802,7 @@ var doc = [
     },
     {
         name: "ENCODEJSON",
-        description: "将JS对象转换成JSON字符串\n\n示例：\n\nENCODEJSON({name: 'amis'}) 得到 '{\"name\":\"amis\"}'",
+        description: "将JS对象转换成JSON字符串。\n\n示例：\n\nENCODEJSON({name: 'amis'}) 得到 '{\"name\":\"amis\"}'。",
         example: "ENCODEJSON({name: 'amis'})",
         params: [
             {
@@ -1819,7 +1819,7 @@ var doc = [
     },
     {
         name: "DECODEJSON",
-        description: "解析JSON编码数据，返回JS对象\n\n示例：\n\nDECODEJSON('{\\\"name\\\": \"amis\"}') 得到 {name: 'amis'}",
+        description: "解析JSON编码数据，返回JS对象。\n\n示例：\n\nDECODEJSON('{\\\"name\\\": \"amis\"}') 得到 {name: 'amis'}。",
         example: "DECODEJSON('{\\\"name\\\": \"amis\"}')",
         params: [
             {
@@ -1836,7 +1836,7 @@ var doc = [
     },
     {
         name: "GET",
-        description: "根据对象或者数组的path路径获取值。 如果解析 value 是 undefined 会以 defaultValue 取代\n\n示例：\n\nGET([0, 2, {name: 'amis', age: 18}], 1) 得到 2\nGET([0, 2, {name: 'amis', age: 18}], '2.name') 得到 'amis'\nGET({arr: [{name: 'amis', age: 18}]}, 'arr[0].name') 得到 'amis'\nGET({arr: [{name: 'amis', age: 18}]}, 'arr.0.name') 得到 'amis'\nGET({arr: [{name: 'amis', age: 18}]}, 'arr.1.name', 'not-found') 得到 'not-found'",
+        description: "根据对象或者数组的path路径获取值。 如果解析 value 是 undefined 会以 defaultValue 取代。\n\n示例：\n\nGET([0, 2, {name: 'amis', age: 18}], 1) 得到 2，\nGET([0, 2, {name: 'amis', age: 18}], '2.name') 得到 'amis'，\nGET({arr: [{name: 'amis', age: 18}]}, 'arr[0].name') 得到 'amis'，\nGET({arr: [{name: 'amis', age: 18}]}, 'arr.0.name') 得到 'amis'，\nGET({arr: [{name: 'amis', age: 18}]}, 'arr.1.name', 'not-found') 得到 'not-found'。",
         example: "GET(arr, 2)",
         params: [
             {