amis-formula 3.1.0 → 3.2.0

package/lib/doc.md

@@ -4,72 +4,74 @@
 
 用法：`IF(condition, consequent, alternate)`
 
- * `condition:expression` 条件表达式.
+ * `condition:expression` 条件表达式。例如：语文成绩>80
  * `consequent:any` 条件判断通过的返回结果
  * `alternate:any` 条件判断不通过的返回结果
 
 返回：`any` 根据条件返回不同的结果
 
-示例：IF(A, B, C)
+如果满足条件condition，则返回consequent，否则返回alternate，支持多层嵌套IF函数。
 
-如果满足条件A，则返回B，否则返回C，支持多层嵌套IF函数。
-
-也可以用表达式如：A ? B : C
+等价于直接用JS表达式如：condition ? consequent : alternate。
 
 ### AND
 
 用法：`AND(expression1, expression2, ...expressionN)`
 
- * `conditions:...expression` 条件表达式.
+ * `conditions:...expression` 条件表达式，多个用逗号隔开。例如：语文成绩>80, 数学成绩>80
 
 返回：`boolean` 
 
-条件全部符合，返回 true，否则返回 false
+条件全部符合，返回 true，否则返回 false。
 
-示例：AND(语文成绩>80, 数学成绩>80)
+示例：AND(语文成绩>80, 数学成绩>80)，
 
-语文成绩和数学成绩都大于 80，则返回 true，否则返回 false
+语文成绩和数学成绩都大于 80，则返回 true，否则返回 false，
 
-也可以直接用表达式如：语文成绩>80 && 数学成绩>80
+等价于直接用JS表达式如：语文成绩>80 && 数学成绩>80。
 
 ### OR
 
 用法：`OR(expression1, expression2, ...expressionN)`
 
- * `conditions:...expression` 条件表达式.
+ * `conditions:...expression` 条件表达式，多个用逗号隔开。例如：语文成绩>80, 数学成绩>80
 
 返回：`boolean` 
 
-条件任意一个满足条件，返回 true，否则返回 false
+条件任意一个满足条件，返回 true，否则返回 false。
 
-示例：OR(语文成绩>80, 数学成绩>80)
+示例：OR(语文成绩>80, 数学成绩>80)，
 
-语文成绩和数学成绩任意一个大于 80，则返回 true，否则返回 false
+语文成绩和数学成绩任意一个大于 80，则返回 true，否则返回 false，
 
-也可以直接用表达式如：语文成绩>80 || 数学成绩>80
+等价于直接用JS表达式如：语文成绩>80 || 数学成绩>80。
 
 ### XOR
 
-用法：`XOR(condition1, condition2)`
+用法：`XOR(condition1, condition2, ...expressionN)`
 
- * `condition1:expression` 条件表达式1
- * `condition2:expression` 条件表达式2
+ * `condition:...expression` 条件表达式，多个用逗号隔开。例如：语文成绩>80, 数学成绩>80
 
 返回：`boolean` 
 
 异或处理，多个表达式组中存在奇数个真时认为真。
 
+示例：XOR(语文成绩 > 80, 数学成绩 > 80, 英语成绩 > 80)
+
+三门成绩中有一门或者三门大于 80，则返回 true，否则返回 false。
+
 ### IFS
 
 用法：`IFS(condition1, result1, condition2, result2,...conditionN, resultN)`
 
- * `args:...any` 条件，返回值集合
+ * `condition:...expression` 条件表达式
+ * `result:...any` 返回值
 
 返回：`any` 第一个满足条件的结果，没有命中的返回 false。
 
 判断函数集合，相当于多个 else if 合并成一个。
 
-示例：IFS(语文成绩 > 80, "优秀", 语文成绩 > 60, "良", "继续努力")
+示例：IFS(语文成绩 > 80, "优秀", 语文成绩 > 60, "良", "继续努力")，
 
 如果语文成绩大于 80，则返回优秀，否则判断大于 60 分，则返回良，否则返回继续努力。
 
@@ -83,7 +85,7 @@
 
 返回：`number` 传入数值的绝对值
 
-返回传入数字的绝对值
+返回传入数字的绝对值。
 
 ### MAX
 
@@ -93,7 +95,7 @@
 
 返回：`number` 所有传入值中最大的那个
 
-获取最大值，如果只有一个参数且是数组，则计算这个数组内的值
+获取最大值，如果只有一个参数且是数组，则计算这个数组内的值。
 
 ### MIN
 
@@ -103,7 +105,7 @@
 
 返回：`number` 所有传入值中最小的那个
 
-获取最小值，如果只有一个参数且是数组，则计算这个数组内的值
+获取最小值，如果只有一个参数且是数组，则计算这个数组内的值。
 
 ### SUM
 
@@ -113,7 +115,7 @@
 
 返回：`number` 所有传入数值的总和
 
-求和，如果只有一个参数且是数组，则计算这个数组内的值
+求和，如果只有一个参数且是数组，则计算这个数组内的值。
 
 ### INT
 
@@ -123,7 +125,7 @@
 
 返回：`number` 数值对应的整形
 
-将数值向下取整为最接近的整数
+将数值向下取整为最接近的整数。
 
 ### MOD
 
@@ -134,20 +136,20 @@
 
 返回：`number` 两数相除的余数
 
-返回两数相除的余数，参数 number 是被除数，divisor 是除数
+返回两数相除的余数，参数 number 是被除数，divisor 是除数。
 
 ### PI
 
 用法：`PI()`
 
-圆周率 3.1415...
+圆周率 3.1415...。
 
 ### ROUND
 
 用法：`ROUND(num[, numDigits = 2])`
 
  * `num:number` 要处理的数字
- * `numDigits:number` 小数位数
+ * `numDigits:number` 小数位数，默认为2
 
 返回：`number` 传入数值四舍五入后的结果
 
@@ -158,7 +160,7 @@
 用法：`FLOOR(num[, numDigits=2])`
 
  * `num:number` 要处理的数字
- * `numDigits:number` 小数位数
+ * `numDigits:number` 小数位数，默认为2
 
 返回：`number` 传入数值向下取整后的结果
 
@@ -169,7 +171,7 @@
 用法：`CEIL(num[, numDigits=2])`
 
  * `num:number` 要处理的数字
- * `numDigits:number` 小数位数
+ * `numDigits:number` 小数位数，默认为2
 
 返回：`number` 传入数值向上取整后的结果
 
@@ -193,7 +195,7 @@
 
 返回：`number` 所有数值的平均值
 
-返回所有参数的平均值，如果只有一个参数且是数组，则计算这个数组内的值
+返回所有参数的平均值，如果只有一个参数且是数组，则计算这个数组内的值。
 
 ### DEVSQ
 
@@ -203,7 +205,7 @@
 
 返回：`number` 所有数值的平均值
 
-返回数据点与数据均值点之差（数据偏差）的平方和，如果只有一个参数且是数组，则计算这个数组内的值
+返回数据点与数据均值点之差（数据偏差）的平方和，如果只有一个参数且是数组，则计算这个数组内的值。
 
 ### AVEDEV
 
@@ -213,7 +215,7 @@
 
 返回：`number` 所有数值的平均值
 
-数据点到其算术平均值的绝对偏差的平均值
+数据点到其算术平均值的绝对偏差的平均值。
 
 ### HARMEAN
 
@@ -223,7 +225,7 @@
 
 返回：`number` 所有数值的平均值
 
-数据点的调和平均值，如果只有一个参数且是数组，则计算这个数组内的值
+数据点的调和平均值，如果只有一个参数且是数组，则计算这个数组内的值。
 
 ### LARGE
 
@@ -234,7 +236,7 @@
 
 返回：`number` 所有数值的平均值
 
-数据集中第 k 个最大值
+数据集中第 k 个最大值。
 
 ### UPPERMONEY
 
@@ -244,7 +246,7 @@
 
 返回：`string` 数值中文大写字符
 
-将数值转为中文大写金额
+将数值转为中文大写金额。
 
 ### RAND
 
@@ -252,9 +254,9 @@
 
 返回大于等于 0 且小于 1 的均匀分布随机实数。每一次触发计算都会变化。
 
-示例：`RAND()*100`
+示例：`RAND()*100`，
 
-返回 0-100 之间的随机数
+返回 0-100 之间的随机数。
 
 ### LAST
 
@@ -264,7 +266,7 @@
 
 返回：`any` 最后一个值
 
-取数据最后一个
+取数据最后一个。
 
 ## 文本函数
 
@@ -298,7 +300,7 @@
 
 返回：`number` 长度
 
-计算文本的长度
+计算文本的长度。
 
 ### LENGTH
 
@@ -308,7 +310,7 @@
 
 返回：`Array<number>` 长度集合
 
-计算文本集合中所有文本的长度
+计算文本集合中所有文本的长度。
 
 ### ISEMPTY
 
@@ -318,7 +320,7 @@
 
 返回：`boolean` 判断结果
 
-判断文本是否为空
+判断文本是否为空。
 
 ### CONCATENATE
 
@@ -328,7 +330,7 @@
 
 返回：`string` 连接后的文本
 
-将多个传入值连接成文本
+将多个传入值连接成文本。
 
 ### CHAR
 
@@ -340,7 +342,7 @@
 
 返回计算机字符集的数字代码所对应的字符。
 
-`CHAR(97)` 等价于 "a"
+示例：`CHAR(97)` 等价于 "a"。
 
 ### LOWER
 
@@ -350,7 +352,7 @@
 
 返回：`string` 结果文本
 
-将传入文本转成小写
+将传入文本转成小写。
 
 ### UPPER
 
@@ -360,7 +362,7 @@
 
 返回：`string` 结果文本
 
-将传入文本转成大写
+将传入文本转成大写。
 
 ### UPPERFIRST
 
@@ -370,7 +372,7 @@
 
 返回：`string` 结果文本
 
-将传入文本首字母转成大写
+将传入文本首字母转成大写。
 
 ### PADSTART
 
@@ -382,11 +384,11 @@
 
 返回：`string` 结果文本
 
-向前补齐文本长度
+向前补齐文本长度。
 
-示例 `PADSTART("6", 2, "0")`
+示例 `PADSTART("6", 2, "0")`，
 
-返回 `06`
+返回 `06`。
 
 ### CAPITALIZE
 
@@ -396,11 +398,11 @@
 
 返回：`string` 结果文本
 
-将文本转成标题
+将文本转成标题。
 
-示例 `CAPITALIZE("star")`
+示例 `CAPITALIZE("star")`，
 
-返回 `Star`
+返回 `Star`。
 
 ### ESCAPE
 
@@ -410,11 +412,11 @@
 
 返回：`string` 结果文本
 
-对文本进行 HTML 转义
+对文本进行 HTML 转义。
 
-示例 `ESCAPE("<star>&")`
+示例 `ESCAPE("<star>&")`，
 
-返回 `&lt;start&gt;&amp;`
+返回 `&lt;start&gt;&amp;`。
 
 ### TRUNCATE
 
@@ -425,11 +427,11 @@
 
 返回：`string` 结果文本
 
-对文本长度进行截断
+对文本长度进行截断。
 
-示例 `TRUNCATE("amis.baidu.com", 6)`
+示例 `TRUNCATE("amis.baidu.com", 6)`，
 
-返回 `amis...`
+返回 `amis...`。
 
 ### BEFORELAST
 
@@ -440,7 +442,7 @@
 
 返回：`string` 判断结果
 
-取在某个分隔符之前的所有字符串
+取在某个分隔符之前的所有字符串。
 
 ### SPLIT
 
@@ -451,11 +453,11 @@
 
 返回：`Array<string>` 文本集
 
-将文本根据指定片段分割成数组
+将文本根据指定片段分割成数组。
 
-示例：`SPLIT("a,b,c", ",")`
+示例：`SPLIT("a,b,c", ",")`，
 
-返回 `["a", "b", "c"]`
+返回 `["a", "b", "c"]`。
 
 ### TRIM
 
@@ -465,7 +467,7 @@
 
 返回：`string` 处理后的文本
 
-将文本去除前后空格
+将文本去除前后空格。
 
 ### STRIPTAG
 
@@ -475,11 +477,11 @@
 
 返回：`string` 处理后的文本
 
-去除文本中的 HTML 标签
+去除文本中的 HTML 标签。
 
-示例：`STRIPTAG("<b>amis</b>")`
+示例：`STRIPTAG("<b>amis</b>")`，
 
-返回：`amis`
+返回：`amis`。
 
 ### LINEBREAK
 
@@ -489,11 +491,11 @@
 
 返回：`string` 处理后的文本
 
-将字符串中的换行转成 HTML `<br>`，用于简单换行的场景
+将字符串中的换行转成 HTML `<br>`，用于简单换行的场景。
 
-示例：`LINEBREAK("\n")`
+示例：`LINEBREAK("\n")`，
 
-返回：`<br/>`
+返回：`<br/>`。
 
 ### STARTSWITH
 
@@ -504,7 +506,7 @@
 
 返回：`string` 判断结果
 
-判断字符串(text)是否以特定字符串(startString)开始，是则返回 True，否则返回 False
+判断字符串(text)是否以特定字符串(startString)开始，是则返回 true，否则返回 false。
 
 ### ENDSWITH
 
@@ -515,7 +517,7 @@
 
 返回：`string` 判断结果
 
-判断字符串(text)是否以特定字符串(endString)结束，是则返回 True，否则返回 False
+判断字符串(text)是否以特定字符串(endString)结束，是则返回 true，否则返回 false。
 
 ### CONTAINS
 
@@ -526,7 +528,7 @@
 
 返回：`string` 判断结果
 
-判断参数 1 中的文本是否包含参数 2 中的文本。
+判断参数 1 中的文本是否包含参数 2 中的文本，是则返回 true，否则返回 false。
 
 ### REPLACE
 
@@ -550,7 +552,7 @@
 
 返回：`number` 命中的位置
 
-对文本进行搜索，返回命中的位置
+对文本进行搜索，返回命中的位置。
 
 ### MID
 
@@ -562,7 +564,7 @@
 
 返回：`number` 命中的位置
 
-返回文本字符串中从指定位置开始的特定数目的字符
+返回文本字符串中从指定位置开始的特定数目的字符。
 
 ### BASENAME
 
@@ -572,11 +574,11 @@
 
 返回：`string` 文件名
 
-返回路径中的文件名
+返回路径中的文件名。
 
-示例：`/home/amis/a.json`
+示例：`/home/amis/a.json`，
 
-返回：a.json`
+返回：a.json`。
 
 ## 日期函数
 
@@ -586,25 +588,25 @@
 
 创建日期对象，可以通过特定格式的字符串，或者数值。
 
-需要注意的是，其中月份的数值是从0开始的，也就是说，
-如果是12月份，你应该传入数值11。
+需要注意的是，其中月份的数值是从0开始的，
+即如果是12月份，你应该传入数值11。
 
 ### TIMESTAMP
 
-用法：`TIMESTAMP(date, 'x')`
+用法：`TIMESTAMP(date[, format = "X"])`
 
  * `date:date` 日期对象
  * `format:string` 时间戳格式，带毫秒传入 'x'。默认为 'X' 不带毫秒的。
 
 返回：`number` 时间戳
 
-返回时间的时间戳
+返回时间的时间戳。
 
 ### TODAY
 
 用法：`TODAY()`
 
-返回今天的日期
+返回今天的日期。
 
 ### NOW
 
@@ -621,11 +623,11 @@
 
 返回：`number` 星期几的数字标识
 
-获取日期的星期几，
+获取日期的星期几。
 
-示例：
+示例
 
-WEEKDAY('2023-02-27') 得到 1
+WEEKDAY('2023-02-27') 得到 1。
 
 ### WEEK
 
@@ -636,11 +638,11 @@ WEEKDAY('2023-02-27') 得到 1
 
 返回：`number` 星期几的数字标识
 
-获取年份的星期，即第几周
+获取年份的星期，即第几周。
 
-示例：
+示例
 
-WEEK('2023-03-05') 得到 10
+WEEK('2023-03-05') 得到 10。
 
 ### DATETOSTR
 
@@ -651,14 +653,14 @@ WEEK('2023-03-05') 得到 10
 
 返回：`string` 日期字符串
 
-对日期、日期字符串、时间戳进行格式化
+对日期、日期字符串、时间戳进行格式化。
 
-示例：
+示例
 
-DATETOSTR('12/25/2022', 'YYYY-MM-DD') 得到 '2022.12.25'
-DATETOSTR(1676563200, 'YYYY.MM.DD') 得到 '2023.02.17'
-DATETOSTR(1676563200000, 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.17 12:00:00'
-DATETOSTR(DATE('2021-12-21'), 'YYYY.MM.DD hh:mm:ss') 得到 '2021.12.21 08:00:00'
+DATETOSTR('12/25/2022', 'YYYY-MM-DD') 得到 '2022.12.25'，
+DATETOSTR(1676563200, 'YYYY.MM.DD') 得到 '2023.02.17'，
+DATETOSTR(1676563200000, 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.17 12:00:00'，
+DATETOSTR(DATE('2021-12-21'), 'YYYY.MM.DD hh:mm:ss') 得到 '2021.12.21 08:00:00'。
 
 ### DATERANGESPLIT
 
@@ -671,16 +673,16 @@ DATETOSTR(DATE('2021-12-21'), 'YYYY.MM.DD hh:mm:ss') 得到 '2021.12.21 08:00:00
 
 返回：`string` 日期字符串
 
-获取日期范围字符串中的开始时间、结束时间
+获取日期范围字符串中的开始时间、结束时间。
 
 示例：
 
-DATERANGESPLIT('1676563200, 1676735999') 得到 [1676563200, 1676735999]
-DATERANGESPLIT('1676563200, 1676735999', undefined , 'YYYY.MM.DD hh:mm:ss') 得到 [2023.02.17 12:00:00, 2023.02.18 11:59:59]
-DATERANGESPLIT('1676563200, 1676735999', 0 , 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.17 12:00:00'
-DATERANGESPLIT('1676563200, 1676735999', 'start' , 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.17 12:00:00'
-DATERANGESPLIT('1676563200, 1676735999', 1 , 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.18 11:59:59'
-DATERANGESPLIT('1676563200, 1676735999', 'end' , 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.18 11:59:59'
+DATERANGESPLIT('1676563200, 1676735999') 得到 [1676563200, 1676735999]，
+DATERANGESPLIT('1676563200, 1676735999', undefined , 'YYYY.MM.DD hh:mm:ss') 得到 [2023.02.17 12:00:00, 2023.02.18 11:59:59]，
+DATERANGESPLIT('1676563200, 1676735999', 0 , 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.17 12:00:00'，
+DATERANGESPLIT('1676563200, 1676735999', 'start' , 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.17 12:00:00'，
+DATERANGESPLIT('1676563200, 1676735999', 1 , 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.18 11:59:59'，
+DATERANGESPLIT('1676563200, 1676735999', 'end' , 'YYYY.MM.DD hh:mm:ss') 得到 '2023.02.18 11:59:59'。
 
 ### STARTOF
 
@@ -692,7 +694,7 @@ DATERANGESPLIT('1676563200, 1676735999', 'end' , 'YYYY.MM.DD hh:mm:ss') 得到 '
 
 返回：`date` 新的日期对象
 
-返回日期的指定范围的开端
+返回日期的指定范围的开端。
 
 ### ENDOF
 
@@ -704,7 +706,7 @@ DATERANGESPLIT('1676563200, 1676735999', 'end' , 'YYYY.MM.DD hh:mm:ss') 得到 '
 
 返回：`date` 新的日期对象
 
-返回日期的指定范围的末尾
+返回日期的指定范围的末尾。
 
 ### YEAR
 
@@ -714,7 +716,7 @@ DATERANGESPLIT('1676563200, 1676735999', 'end' , 'YYYY.MM.DD hh:mm:ss') 得到 '
 
 返回：`number` 数值
 
-返回日期的年份
+返回日期的年份。
 
 ### MONTH
 
@@ -734,7 +736,7 @@ DATERANGESPLIT('1676563200, 1676735999', 'end' , 'YYYY.MM.DD hh:mm:ss') 得到 '
 
 返回：`number` 数值
 
-返回日期的天
+返回日期的天。
 
 ### HOUR
 
@@ -744,7 +746,7 @@ DATERANGESPLIT('1676563200, 1676735999', 'end' , 'YYYY.MM.DD hh:mm:ss') 得到 '
 
 返回：`number` 数值
 
-返回日期的小时
+返回日期的小时。
 
 ### MINUTE
 
@@ -754,7 +756,7 @@ DATERANGESPLIT('1676563200, 1676735999', 'end' , 'YYYY.MM.DD hh:mm:ss') 得到 '
 
 返回：`number` 数值
 
-返回日期的分
+返回日期的分。
 
 ### SECOND
 
@@ -764,7 +766,7 @@ DATERANGESPLIT('1676563200, 1676735999', 'end' , 'YYYY.MM.DD hh:mm:ss') 得到 '
 
 返回：`number` 数值
 
-返回日期的秒
+返回日期的秒。
 
 ### YEARS
 
@@ -775,7 +777,7 @@ DATERANGESPLIT('1676563200, 1676735999', 'end' , 'YYYY.MM.DD hh:mm:ss') 得到 '
 
 返回：`number` 数值
 
-返回两个日期相差多少年
+返回两个日期相差多少年。
 
 ### MINUTES
 
@@ -786,7 +788,7 @@ DATERANGESPLIT('1676563200, 1676735999', 'end' , 'YYYY.MM.DD hh:mm:ss') 得到 '
 
 返回：`number` 数值
 
-返回两个日期相差多少分钟
+返回两个日期相差多少分钟。
 
 ### DAYS
 
@@ -797,7 +799,7 @@ DATERANGESPLIT('1676563200, 1676735999', 'end' , 'YYYY.MM.DD hh:mm:ss') 得到 '
 
 返回：`number` 数值
 
-返回两个日期相差多少天
+返回两个日期相差多少天。
 
 ### HOURS
 
@@ -808,7 +810,7 @@ DATERANGESPLIT('1676563200, 1676735999', 'end' , 'YYYY.MM.DD hh:mm:ss') 得到 '
 
 返回：`number` 数值
 
-返回两个日期相差多少小时
+返回两个日期相差多少小时。
 
 ### DATEMODIFY
 
@@ -820,11 +822,11 @@ DATERANGESPLIT('1676563200, 1676735999', 'end' , 'YYYY.MM.DD hh:mm:ss') 得到 '
 
 返回：`date` 日期对象
 
-修改日期，对日期进行加减天、月份、年等操作
+修改日期，对日期进行加减天、月份、年等操作。
 
 示例：
 
-DATEMODIFY(A, -2, 'month')
+DATEMODIFY(A, -2, 'month')，
 
 对日期 A 进行往前减2月的操作。
 
@@ -851,7 +853,7 @@ DATEMODIFY(A, -2, 'month')
 
 返回：`boolean` 判断结果
 
-判断两个日期，是否第一个日期在第二个日期的前面
+判断两个日期，是否第一个日期在第二个日期的前面，是则返回 true，否则返回 false。
 
 ### ISAFTER
 
@@ -863,7 +865,7 @@ DATEMODIFY(A, -2, 'month')
 
 返回：`boolean` 判断结果
 
-判断两个日期，是否第一个日期在第二个日期的后面
+判断两个日期，是否第一个日期在第二个日期的后面，是则返回 true，否则返回 false。
 
 ### BETWEENRANGE
 
@@ -876,9 +878,9 @@ DATEMODIFY(A, -2, 'month')
 
 返回：`boolean` 判断结果
 
-判断日期是否在指定范围内
+判断日期是否在指定范围内，是则返回 true，否则返回 false。
 
-示例：BETWEENRANGE('2021/12/6', ['2021/12/5','2021/12/7'])
+示例：BETWEENRANGE('2021/12/6', ['2021/12/5','2021/12/7'])。
 
 ### ISSAMEORBEFORE
 
@@ -890,7 +892,7 @@ DATEMODIFY(A, -2, 'month')
 
 返回：`boolean` 判断结果
 
-判断两个日期，是否第一个日期在第二个日期的前面或者相等
+判断两个日期，是否第一个日期在第二个日期的前面或者相等，是则返回 true，否则返回 false。
 
 ### ISSAMEORAFTER
 
@@ -902,7 +904,7 @@ DATEMODIFY(A, -2, 'month')
 
 返回：`boolean` 判断结果
 
-判断两个日期，是否第一个日期在第二个日期的后面或者相等
+判断两个日期，是否第一个日期在第二个日期的后面或者相等，是则返回 true，否则返回 false。
 
 ## 数组
 
@@ -914,7 +916,7 @@ DATEMODIFY(A, -2, 'month')
 
 返回：`boolean` 结果
 
-返回数组的长度
+返回数组的长度。
 
 ### ARRAYMAP
 
@@ -953,7 +955,7 @@ DATEMODIFY(A, -2, 'month')
 
 示例：
 
-ARRAYFINDINDEX([0, 2, false], item => item === 2) 得到 1
+ARRAYFINDINDEX([0, 2, false], item => item === 2) 得到 1。
 
 ### ARRAYFIND
 
@@ -969,7 +971,7 @@ ARRAYFINDINDEX([0, 2, false], item => item === 2) 得到 1
 
 示例：
 
-ARRAYFIND([0, 2, false], item => item === 2) 得到 2
+ARRAYFIND([0, 2, false], item => item === 2) 得到 2。
 
 ### ARRAYSOME
 
@@ -981,11 +983,11 @@ ARRAYFIND([0, 2, false], item => item === 2) 得到 2
 返回：`boolean` 结果
 
 数据做数据遍历判断，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。
-判断第二个箭头函数是否存在返回为 true 的成员。
+判断第二个箭头函数是否存在返回为 true 的成员，是则返回 true，否则返回 false。
 
 示例：
 
-ARRAYSOME([0, 2, false], item => item === 2) 得到 true
+ARRAYSOME([0, 2, false], item => item === 2) 得到 true。
 
 ### ARRAYEVERY
 
@@ -997,7 +999,7 @@ ARRAYSOME([0, 2, false], item => item === 2) 得到 true
 返回：`boolean` 结果
 
 数据做数据遍历判断，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。
-判断第二个箭头函数返回是否都为 true。
+判断第二个箭头函数返回是否都为 true，是则返回 true，否则返回 false。
 
 示例：
 
@@ -1012,11 +1014,11 @@ ARRAYEVERY([0, 2, false], item => item === 2) 得到 false
 
 返回：`any` 结果
 
-判断数据中是否存在指定元素
+判断数据中是否存在指定元素。
 
 示例：
 
-ARRAYINCLUDES([0, 2, false], 2) 得到 true
+ARRAYINCLUDES([0, 2, false], 2) 得到 true。
 
 ### COMPACT
 
@@ -1026,11 +1028,11 @@ ARRAYINCLUDES([0, 2, false], 2) 得到 true
 
 返回：`Array<any>` 结果
 
-数组过滤掉 false、null、0 和 ""
+数组过滤掉 false、null、0 和 ""。
 
 示例：
 
-COMPACT([0, 1, false, 2, '', 3]) 得到 [1, 2, 3]
+COMPACT([0, 1, false, 2, '', 3]) 得到 [1, 2, 3]。
 
 ### JOIN
 
@@ -1041,11 +1043,11 @@ COMPACT([0, 1, false, 2, '', 3]) 得到 [1, 2, 3]
 
 返回：`String` 结果
 
-数组转成字符串
+数组转成字符串。
 
 示例：
 
-JOIN(['a', 'b', 'c'], '=') 得到 'a=b=c'
+JOIN(['a', 'b', 'c'], '=') 得到 'a=b=c'。
 
 ### CONCAT
 
@@ -1055,11 +1057,11 @@ JOIN(['a', 'b', 'c'], '=') 得到 'a=b=c'
 
 返回：`Array<any>` 结果
 
-数组合并
+数组合并。
 
 示例：
 
-CONCAT(['a', 'b', 'c'], ['1'], ['3']) 得到 ['a', 'b', 'c', '1', '3']
+CONCAT(['a', 'b', 'c'], ['1'], ['3']) 得到 ['a', 'b', 'c', '1', '3']。
 
 ### UNIQ
 
@@ -1070,11 +1072,11 @@ CONCAT(['a', 'b', 'c'], ['1'], ['3']) 得到 ['a', 'b', 'c', '1', '3']
 
 返回：`Array<any>` 结果
 
-数组去重，第二个参数「field」，可指定根据该字段去重
+数组去重，第二个参数「field」，可指定根据该字段去重。
 
 示例：
 
-UNIQ([{a: '1'}, {b: '2'}, {a: '1'}]， 'id')
+UNIQ([{a: '1'}, {b: '2'}, {a: '1'}]， 'id')。
 
 ## 编码
 
@@ -1086,11 +1088,11 @@ UNIQ([{a: '1'}, {b: '2'}, {a: '1'}]， 'id')
 
 返回：`string` 结果
 
-将JS对象转换成JSON字符串
+将JS对象转换成JSON字符串。
 
 示例：
 
-ENCODEJSON({name: 'amis'}) 得到 '{"name":"amis"}'
+ENCODEJSON({name: 'amis'}) 得到 '{"name":"amis"}'。
 
 ### DECODEJSON
 
@@ -1100,11 +1102,11 @@ ENCODEJSON({name: 'amis'}) 得到 '{"name":"amis"}'
 
 返回：`object` 结果
 
-解析JSON编码数据，返回JS对象
+解析JSON编码数据，返回JS对象。
 
 示例：
 
-DECODEJSON('{\"name\": "amis"}') 得到 {name: 'amis'}
+DECODEJSON('{\"name\": "amis"}') 得到 {name: 'amis'}。
 
 ## 其他
 
@@ -1118,15 +1120,15 @@ DECODEJSON('{\"name\": "amis"}') 得到 {name: 'amis'}
 
 返回：`any` 结果
 
-根据对象或者数组的path路径获取值。 如果解析 value 是 undefined 会以 defaultValue 取代
+根据对象或者数组的path路径获取值。 如果解析 value 是 undefined 会以 defaultValue 取代。
 
 示例：
 
-GET([0, 2, {name: 'amis', age: 18}], 1) 得到 2
-GET([0, 2, {name: 'amis', age: 18}], '2.name') 得到 'amis'
-GET({arr: [{name: 'amis', age: 18}]}, 'arr[0].name') 得到 'amis'
-GET({arr: [{name: 'amis', age: 18}]}, 'arr.0.name') 得到 'amis'
-GET({arr: [{name: 'amis', age: 18}]}, 'arr.1.name', 'not-found') 得到 'not-found'
+GET([0, 2, {name: 'amis', age: 18}], 1) 得到 2，
+GET([0, 2, {name: 'amis', age: 18}], '2.name') 得到 'amis'，
+GET({arr: [{name: 'amis', age: 18}]}, 'arr[0].name') 得到 'amis'，
+GET({arr: [{name: 'amis', age: 18}]}, 'arr.0.name') 得到 'amis'，
+GET({arr: [{name: 'amis', age: 18}]}, 'arr.1.name', 'not-found') 得到 'not-found'。
 
 ### ISTYPE