「标准」Ux.valueAppend

不重复追加值到item对象中（包含则不设置）

框架内部的使用代码如：

    const {$clear, form} = reference.props;
    // 记录切换：从更新表单 -> 添加表单切换
    if ($clear && $clear.is()) {
         const keys = $clear.to();
         keys.forEach(key => Value.valueAppend(data, key, undefined));
    }

这里需要解释这个API和Ux.assign（mode=2）的区别，在Ux.assign中，追加模式是做合并，而且追加时支持嵌套追加，

除了顶层Object以外它的子对象也会实现合并追加流程，而Ux.valueAppend是单纯的值追加过程，只在当前传入对象中追加

是否包含了field的情况。

示例：

const item = {
    "name": "emma",
    "phone": "13550878787"
}
Ux.valueAppend(item, "age", 18);

上述代码执行过后

item = {
    "name": "emma",
    "phone": "13550878787",
    "age": 18
}

「标准」Ux.valueArray

对数据进行规范化解析，确保转换过后的一定是 Array 。

1. 如果 input = undefined，返回 []
2. 如果 input = Array，直接返回
3. 如果 input = Object，则检查 list 节点（必须是Array）

「标准」Ux.valueBoolean

将输入的数据转换为 boolean 类型。

示例：

const value1 = "true";
const output1 = Ux.valueBoolean(value1);

const value2 = "123";
const output2 = Ux.valueBoolean(value2);

// 最终结果
// output1 的值为 true
// output2 的值为 false

「标准」Ux.valueCopy

该函数负责将 field 字段中的信息从 source 拷贝到 target 中。

1. field 为 String：拷贝单个字段数据
2. field 为 Array：拷贝多个字段数据
3. 如果读取的数据为 Object / Array 则采用深度拷贝

示例：

const params1 = {
    "orderId": "239975a7-f164-43b3-a9d1-4516f98c1948",
    "amount": 120,
    "signMobile": "18604409876",
    "indent": "NUM.PAYBILL",
    "language": "cn",
    "level": 2,
    "name": "ox.rbac.role"
}
const params2 = {
    "language": "en",
    "level": 3,
    "name": "ox.rbac.role"
}
const value = Ux.valueCopy(params1, [
        "orderId",
        "amount",
        "signMobile",
        "indent"
    ], params2);

执行上述代码之后的结果：

value = {
    "orderId": "239975a7-f164-43b3-a9d1-4516f98c1948",
    "amount": 120,
    "signMobile": "18604409876",
    "indent": "NUM.PAYBILL",
    "language": "en",
    "level": 3,
    "name": "ox.rbac.role"
}

「标准」Ux.valueDatetime

时间转换标准函数，将字符串格式的对象转换成合法 Dayjs 对象，返回失败则报错。

示例写法：

const now = Ux.valueDatetime(Ux.valueNow("HH:mm:ss"), "HH:mm:ss");

可支持的 format 格式信息详见 Ux.valueNow 。

「标准」Ux.valueDuration

根据from和to计算中间的duration差值。

支持8种计算模式，如下表所示：(各个传入的模式对大小写不敏感，支持缩写和复数。）

示例：

const startDate = "2022-06-05";
const mode = "month";
const endDate = "2023-01-25";
const duration = Ux.valueDuration(startDate, endDate, mode);

返回结果：

duration => 7

「标准」Ux.valueEndTime

根据开始时间、间隔、模式计算结束时间

支持8种模式，如下表所示：(各个传入的模式对大小写不敏感，支持缩写和复数。）

示例：

const startDate = "2023-06-04 19:06:55";
const mode1 = "year";
const endDate1 = Ux.valueEndTime(startDate, 7, mode1);
const mode2 = "hour";
const endDate2 = Ux.valueEndTime(startDate, 7, mode2);

返回结果：

endDate1 => "2024-01-04 19:06:55"
endDate2 => "2023-06-05 02:06:55"

「引擎」Ux.valueExpr

（通常内部）解析表达式强化方法，主要用于解析Zero中带:的自定义表达式相关信息。

const user = {
    username: "Lang",
    age: 12
};

const keepValue = Ux.valueExpr("你的名字:username", user, true);
// 输出：你的名字Lang。
// 执行后 user 的值为：{ username: "Lang", age: 12 };

const removeValue = Ux.valueExpr("你的名字:username", user);
// 输出：你的名字Lang。
// 之后后 user 的值：{ age:12 }; 原始的 username 已经从输入Object中移除。

注意第三参数，第三参数会对传入参数执行保留或不保留的两种方案，如果 keep = false（默认），那么在执行过后，原始入参中 被替换的参数属性会被移除掉，而 keep = true 时则不会移除，会保留其数据信息，并且注意该方法和Ux.formatExpr的区别， 通常valueExpr是直接使用，建议在内部调用，而formatExpr会有更多操作，所以提供给用户调用。

「标准」Ux.valueFactor

因子计算函数，将一个带 % 号的字符串转换成浮点数，转换不成功则返回 undefined 。

示例：

const item = "62.5%";
const value = Ux.valueFactor(item);

// value 的值为 0.625

「引擎」Ux.valueFind

配置解析统一调用函数（特殊应用）

1. 如果 attrPath 长度为1，则直接提取 target 中的：target[attrPath[0]]。
2. 如果长度大于2，则先提取target[attrPath[0]]，其次提取第二阶段名称，暂时只支持长度为2的模式。

内部执行函数代码示例。

 PROP: (expression, {props}) => fnPredicate("PROP", expression, () => {
     const path = expression.split('.'); // 路径解析
     return T.valueFind(props, path);
 }),

「标准」Ux.valueFloat

将一个字符串转换成合法浮点数，保证转换成功，如果出现转换失败，取默认值。

示例：

const valid = "12.1";
const okValue = Ux.valueFloat(valid, 0.0, 1);

const invalid = null;
const koValue = Ux.valueFloat(invalid, 0.00);

// 最终结果
// okValue 的值为 12.1
// koValue 的值为 0.00

「标准」Ux.valueInt

将一个字符串转换成整数，保证转换成功，如果出现转换失败，取默认值。

const valid = "1231";
const okValue = Ux.valueInt(valid, 12);

const invalid = null;
const koValue = Ux.valueInt(invalid, 12);

// 最终结果
// okValue 的值为 1231
// koValue 的值为 12

「标准」Ux.valueJDatetime

时间转换专用函数，将对象中的 Object 中所有 fields 字段转换成时间格式。

这个函数只支持 ISO 格式，批量转换对象中的字段。

示例：

const value = {
    cretedAt: "xxx",
    updatedAt: "xxx"
}
// 下列代码会将 value 对象中的 cretedAt 和 updatedAt 字段信息均转换为 ISO 的时间格式。
const value2 = Ux.valueJDatetime(value, "cretedAt", "updatedAt");
// 等价于
const value2 = Ux.valueJDatetime(value, ["cretedAt", "updatedAt"]);

「标准」Ux.valueLadder

梯度处理专用函数，函数执行流程

1. 先全部拉平，生成带.属性的对象（一层结构）。
2. 按照拉平的属性名进行排序（顺序处理）。
3. 然后执行结构化，将所有的.操作符移除。

最终目的是生成Json树。

const config = {
    "optionJsx.item": 12,
    "optionItem.label": "标签",
    "field": "email",
    "optionItem.style.color": "red",
    "ajax.magic.params": {
        "name": "Lang",
        "age": 13
    }
}
const values = Ux.valueLadder(config);

上述代码执行过后，会返回下边的结果：

{
    "ajax":{
        "magic":{
            "params":{
                "name": "Lang",
                "age": 13
            }
        }
    },
    "field": "email",
    "optionItem":{
        "label": "标签",
        "style": {
            "color": "red"
        }
    },
    "optionJsx":{
        "item": 12
    }
}

「标准」Ux.valueLink

vConn = true

M1 = {
    "k1": "v1",
    "k2": "v2"
},

M2 = {
    "v1": "value1",
    "v2": "value2"
}

R = {
    "k1": "value1",
    "k2": "value2"
}

vConn = false

M1 = {
    "k1": "v1",
    "k2": "v2"
},

M2 = {
    "k1": "value1",
    "k2": "value2"
}

R = {
    "v1": "value1",
    "v2": "value2"
}

「标准」Ux.valueMap

此函数与valueOk功能很像，为将 config 中的信息作为映射将 source 的信息拷贝到 target 。

示例：

const source = {
     username: "emma"
}
const target = {
     email: "1096721799@qq.com"
}
const config = {
     username: "userfullname"
}
const value = Ux.valueMap(target, source, config);

执行上述代码之后的结果为：

value = {
    userfullname: "emma",
    email: "1096721799@qq.com"
}

「标准」Ux.valueNow

返回当前时间，直接得到 Dayjs 对象。

如果没有传 pattern 参数，则默认返回 ISO 8601 字符串。

示例（假设当前时间为2019-01-25 00:00:00)

const dateNow = Ux.valueNow();
// 执行上述代码之后，dateNow = '2019-01-25T02:00:00.000Z'

可支持的格式化占位符列表如下：

「引擎」Ux.valueOk

该函数负责将 field 字段中的信息从 source 拷贝到 target 中。

1. field 为 String：拷贝单个字段数据
2. field 为 Array：拷贝多个字段数据
3. 如果读取的数据为 Array 则采用深度拷贝

示例：

const params1 = {
    "orderId": "239975a7-f164-43b3-a9d1-4516f98c1948",
    "amount": 120,
    "signMobile": "18604409876",
    "indent": "NUM.PAYBILL",
    "language": "cn",
    "level": 2,
    "name": "ox.rbac.role"
}
const params2 = {
    "language": "en",
    "level": 3,
    "name": "ox.rbac.role"
}
const value = Ux.valueOk(params1, [
        "relatedId,orderId",
        "amount",
        "signMobile",
        "indent=NUM.SETTLEMENT"
    ], params2);

执行上述代码之后的结果：

value = {
    "relatedId": "239975a7-f164-43b3-a9d1-4516f98c1948",
    "amount": 120,
    "signMobile": "18604409876",
    "indent": "NUM.SETTLEMENT",
    "language": "en",
    "level": 3,
    "name": "ox.rbac.role"
}

「标准」Ux.valuePair

表达式解析成对象的专用函数

1. 如果 expr 是 String 则执行解析。
2. 如果 expr 是 Object类型，则直接返回 expr 这个对象。

注意：如果值里面本身包含了逗号，则需要用markdown专用的语法对逗号进行转换。

const user = "username=Lang,email=lang.yu@hpe.com";
const userObj = Ux.valuePair(user);

上述代码执行后生成格式如：

{
    "username": "Lang",
    "email": "lang.yu@hpe.com"
}

「标准」Ux.valueParse

将字符串解析成

{
    "type": "解析类型",
    "expression": "最终表达式"
}

示例：

const value = "PROP:app.mHotel.key";
const outValue = Ux.valueParse(value);

最终解析成：

{
    "type": "PROP",
    "expression": "app.mHotel.key"
}

「标准」Ux.valuePath

对象树检索专用函数，可根据 path 检索对象树

示例：

const user = {
    "teacher":{
        "son":{
            "username": "Lang"
        }
    }
}
const teacher = Ux.valuePath(user, "teacher");
const son = Ux.valuePath(user, "teacher.son");
const username = Ux.valuePath(user, "teacher.son.username");

返回结果：

teacher = { "son":{ "username": "Lang" } }
son = { "username": "Lang"}
username = "Lang"

「标准」Ux.valuePinyin

将汉字转换成拼音，在某些场景中，中文字转换成拼音后可根据拼音的字典序进行排列，这是业务场景所必须的，这种转换 也是有必要的，而系统中主要使用了js-pinyin模块实现直接转换，封装了第三方库。

示例：

const name = "虞浪";
const pinyin = Ux.valuePinyin(name);

返回结果：

pinyin => "yulang"

「标准」Ux.valueSTDN

此API功能与 valueT 相似，均为类型保障，区别在于 valueT 是单值处理，而 valueSTDN 为全值处理。

类型支持的值如下：

• BOOLEAN: 布尔值
• INTEGER：整数
• DECIMAL：浮点数
• STRING：字符串
• TIME：时间
• DATETIME：日期时间
• DATE：日期

虽然目前服务端和客户端支持的类型一致，但有些细节有区别，比如客户端的时间是 HH:mm 格式，而服务端为 HH:mm:ss 格式。

简单示例如下：

const value = {
    "active": "true",
    "__metadata":{
        "active": "BOOLEAN"
    }
}
// 使用客户端解析模式，根据 __metadata 的设置，将 active 的值类型转换为 BOOLEAN。
const data1 = Ux.valueSTDN(value);
// 使用服务端解析模式，根据 __metadata 的设置，将 active 的值类型转换为 BOOLEAN。
const data2 = Ux.valueSTDN(value, true);

「标准」Ux.valueStartTime

根据结束时间、间隔、模式计算开始时间

支持8种模式，如下表所示：(各个传入的模式对大小写不敏感，支持缩写和复数。）

示例：

const endDate = "2023-06-04 19:06:55";
const mode1 = "year";
const startDate1 = Ux.valueStartTime(endDate, 7, mode1);
const mode2 = "hour";
const startDate2 = Ux.valueStartTime(endDate, 7, mode2);

返回结果：

startDate1 => "2022-11-04 19:06:55"
startDate2 => "2023-06-04 12:06:55"

「标准」Ux.valueSubset

将传入的 input 数据根据 fields 取子集。

示例如下：

const input = {
    "name": "lang",
    "age": 18,
    "email": "email@xx.com",
    "active": undefined
}

// 对 input 取子集，只取字段 "name","age","active"，生成新的子集并返回。
const value = Ux.valueSubset(input, ["name","age","active"]);
// 等价于
const value = Ux.valueSubset(input, "name", "age", "active");

最终执行过后，返回的value值为：

{
     "name": "lang",
     "age": 18
}

注意：如果值为 undefined ，则不会被取出，示例中字段 active 就没有被取出。

「标准」Ux.valueT

将传入的数据转换为指定的类型（类型保障），类型支持的值如下：

• BOOLEAN, B: 布尔值
• INTEGER, I：整数
• DECIMAL, D：浮点数

注意：

1、在执行转换之前，会进行判断，当传入的值为 undefined 时，不进行转换。 2、当传入的类型不为上述类型，则默认转换为 String。 3、类型转换的解析模式为 客户端 模式，即用 JavaScript 的方式。

传入的类型可以为简写值，示例如下：

const value = "true";
const data = Ux.valueT(value, "BOOLEAN");
// 等价于
const data = Ux.valueT(value, "B");

「标准」Ux.valueValid

将输入数据处理成合法对象，两种模式处理对象Object，由于后端无法识别某些值，所以执行下边处理

1. 宽模式，0, null, undefined，false 都会被移除，包括 ""。
2. 严格模式，仅移除 undefined，其他的保留。

const data = {
     "username": "Lang",
     "email": null,
     "age": 0,
     "active": false,
     "address": undefined
}
// 宽模式
const data1 = Ux.valueValid(data, true);
// 严模式
const data2 = Ux.valueValid(data);

最终结果

data1 = {
      "username": "Lang"
 }
data2 = {
      "username": "Lang",
      "email": null,
      "age": 0,
      "active": false
 }