安装

第一步，改变我们的源，如果需要

npm i -g nrm   
nrm use npm;

第二步，安装包，

npm i lq-tool --save;     

第三步，在我们需要的地方引入包，就可以直接用了。

// 首先，引入工具包
import { DateUtil } from 'lq-tool'

// 比如上边引用的是DateUtil；在下边就可以直接引用DateUtil了。
let timeFormat = DateUtil.formatDate(1234567899875);
console.log(DateUtil)
console.log(timeFormat)

// 输出以下东西
function DateUtil() {
    _classCallCheck(this, DateUtil);
}
2009-02-14 07:31:39

使用

这个包主要说的是一些常用的工具类，比如:

• 时间格式的转换DateUtil
• 数组操作工具ArrayUtil
• 缓存工具CookUtil
• 字符串工具StringUtil
• 历史浏览工具HistoryUtil
• 对象操作工具ObjectUtil
• 数学操作工具MathUtil
• 深拷贝DeepClone
• 正则校验RegularUtil
• 两个值比较CompareUtil
• 金钱格式MoneyFormat
• 项目检测CountlyUtil
• 功能监控FunDebugUtil

时间工具

====== 1. formatDate ======

将各种类型的值转变成我们需要的格式。

// 例一
let timeFormat =  formatDate(10000,"HH:mm:ss");// 数值会当成时间戳来计算

timeFormat // 08:00:10
// 按照1970-01-01 08:00:00 来算的

// 例二
let timeFormat =  DateUtil.formatDate(new Date());// 数值会当成时间戳来计算

timeFormat // 2017-07-27 17:48:58
// 这个随着时间的改变而改变

数组工具

数组操作工具类目前分为几个函数：

====== 1. isArray ======

判断我们输入的参数是不是一个数组。是的话返回true，否则为false。

let arr = [1,2,3];

let flag = ArrayUtil.isArray(arr);

flag // true

====== 2. flatten ======

将多维数组转化成一维数组。

let arr = [[1, 2, 3], [4, 5, 6], 7, [8]];

resultArr = ArrayUtil.flatten(arr);

resultArr // [1, 2, 3, 4, 5, 6, 7, 8]

====== 3. dislodge ======

给定两个数组，输出数组1里边在数组2里边不存在的元素。

let arr1 = [1,2,3,5,67,8];
let arr2 = [1,3,5,7,9];

ArrayUtil.dislodge(arr1,arr2); // [2,67,8]

====== 4. merge ======

将两个数组去重合并。

let arr1 = [1,2,3,5,67,8,8];
let arr2 = [1,3,5,7,9,9];

let result = ArrayUtil.merge(arr1,arr2));

result // [1,2,3,5,67,8,7,9]

====== 5. containAnother ======

判断数组1是否包含数组2。

// 
var array1 = [1,3,5,7,9];
var array2 = [1,3,5];

ArrayUtil.containAnother(array1, array2); // true

注意，当两个数组为空的时候返回false.

深拷贝

====== deepClone ====== 对传入的参数进行深度克隆。

// 如果我们传入的值是null或者不是一个对象，则会返回传入的值。
let resultNull = ArrayUtil.deepClone(null);
let resultStr = ArrayUtil.deepClone("xiaolb");
let resultNum = ArrayUtil.deepClone(22);

resultNull // null
resultStr // "xiaolb"
resultNum // 22

// 如果传入的是除上述情况的其他情况，传入什么输出什么。
ArrayUtil.deepClone(function(){})  // function(){}
ArrayUtil.deepClone({0:"a",1:"b",2:"c"}) // {0:"a",1:"b",2:"c"}
ArrayUtil.deepClone([1,2]) // [1,2]

缓存工具

缓存工具类目前分为几个函数：

====== 1. setCookie =====

建立cookie,一般用来存储用户名、密码之类的数据

名字 | 含义 | 是否必须 :----: | :----: | :----: name | cookie的名字 | require value | cookie的值| require expires | cookie的过期时间（格林威治时间）| option path | 默认当前的路径（必须为绝对路径）| option domain | 默认为当前文档位置的路径的域名部分| option secure | cookie只会被https传输（boolern）| option

//setCookie(name, value, expires, path, domain, secure)
let cookie = CookieUtil.setCookie('admin','root',new Date(new Date().getTime()))
cookie // "xlb=people; expires=Fri Jul 28 2017 08:09:57 GMT+0800 (中国标准时间)"

====== 2. getCookie =====

获取cookie的值

let value = CookieUtil.getCookie('admin')
value // 'root'

====== 3. getCookieVal =====

获取cookie的键值对

let value = CookieUtil.getCookieVal()

value // 'admin=root'

====== 4. deleteCookie =====

删除cookie

let value = CookieUtil.deleteCookie('xlb')
value // ''

字符串工具

字符串工具类目前分为几个函数：

====== 1. repeat ====== 使用矩阵快速幂来处理字符串连接。

第一个参数是字符串
第二个参数是数字

 // eg:
 StringUtil.repeat('sjdh',4) // 'sjdhsjdhsjdhsjdh'

传入的第一个参数必须为字符串，否则会报错

====== 2. padZeroLeft ======

在字符串左边填充"0"。

// eg1:
let  resultStr = StringUtil.padZeroLeft("xiaolb",9);
resultStr // "000xiaolb"

// eg2:
let  resultStr = StringUtil.padZeroLeft(12345678,9);
resultStr // "012345678"

如果传入的字符串的长度比传入的数组大的话，返回的是原字符串。

====== 3. trim ======

去掉字符串首尾的空格

let a = '              sjdh    '
var offset = StringUtil.trim(a);

offset // 'sjhd'

====== 4. OnlyInt ======

只能输入数字并且限定了长度

StringUtil.OnlyInt("sdf123456789",3); // 123

对象操作工具

对象操作工具类目前分为几个函数：

====== 1. isEmptyObject ======

判断对象是不是为空值，是的话返回true,否则为false.

// eg1:
var obj = {};
var resultObj = ObjectUtil.isEmptyObject(obj);

resultObj; // true


// eg2:
var obj = {"1":'1'};
var resultObj = ObjectUtil.isEmptyObject(obj);

resultObj; // false

====== 2. cloneObjExceptParam ======

克隆一个新的对象除了指定的属性名。

var obj = {"name":"xiaolb","sex":"man","age":"secret"};
var paramName = "name";
var resultObj = ObjectUtil.cloneObjExceptParam(obj,paramName);

resultObj; // {"sex":"man","age":"secret"}

历史浏览工具

历史浏览工具类目前分为几个函数：

====== 1. goBack ======

返回上一个页面，数据会全部刷新，不会保留。

goBack()

数学操作工具

数学操作工具类目前分为几个函数：

====== 1. randomInteger ======

在[start,end]内生成随机数整数，并返回该数。

var number = MathUtil.randomInteger(10,12);

number; //在[10,12]随机的一个整数。

正则校验

正则校验工具类目前分为几个函数：

====== 1. regPhone ======

校验是否为手机号

var value1 = RegularUtil.regPhone('15990357136')
var value1 = RegularUtil.regPhone('12990357136')
value1; // true
value2; // false

====== 2. regIdCard ======

校验是否为身份证号

var value1 = RegularUtil.regIdCard('445644123456789')
var value1 = RegularUtil.regIdCard('132456789465789123')
value1; // true
value2; // true

====== 3. regNumber ======

校验是否为正数

var value1 = RegularUtil.regNumber(456789)
var value1 = RegularUtil.regNumber(-132456789465789123)
value1; // true
value2; // false

====== 4. regNumWord ======

校验是否为字母+数字

var value1 = RegularUtil.regNumWord('f45s67s89s')
var value1 = RegularUtil.regNumWord('132456789465789123z@')
value1; // true
value2; // false

====== 5. pattern ======

自己写正则和检验值 pattern(reg, value)

var value1 = RegularUtil.pattern(/\d/,1)
value1; // true

两个值比较

两个值比较工具类目前分为几个函数：

====== 1. compare2Objects ======

比较两个对象是否相等,相等返回空数组，不相等返回不相等的属性名 compare2Objects(obj1, obj2)

var obj1 = {
  "key": 1,
  "key1": 2,
  "key2": 4,
  "key4": function() {},
  "key3":{
    key31: 1,
    key32: {
      key321: 1
    }
  },
  key5:[1,2,3]
}

var obj2 = {
  "key": 1,
  "key1": 2,
  "key2": 4,
  "key4": function() {},
  "key3":{
    key31: 1,
    key32: {
      key321:1
    }
  },
  key5: [1,2,3],
}

compare2Objects(obj1, obj2) // []

obj2.key6 = 2;

compare2Objects(obj1, obj2) // ["key6"]

obj2.key3.key32.key321 = 2;

compare2Objects(obj1, obj2) // ["key6", "key3"]

金钱格式

金钱格式工具类目前分为几个函数：

====== 1. fMoney ======
将number类型的数字转化成X,XXX,XXX.XXX类型的金钱格式,在保留的小数位上会四舍五入。
fMoney(money, num);

let money1 = 1234567.12356, num1 = 3;
fMoney(money1, num1); // 1,234,567.124

let money2 = -1234567.12356, num2 = 3;
fMoney(money2, num2); // -1,234,567.124

====== 2. rMoney ======
将金钱格式的数字转化成数字形式。
rMoney(money);

let moeny = 1,234,567.1234;

rMoney(moeny) // 1234567.1234

项目检测countly

项目检测countly工具类目前分为几个函数：

====== 1. init ======
// appKey指的是countly上边我们对应的appKey;
// env指的是对应的环境 init(appKey, env);

功能监控FunDebugUtil

import { FunDebugUtil } from 'lq-tool';

FunDebugUtil.init(<apiKey>, <env>, <version>, <userName>, <options>);

• apiKey为fundebug的apiKey
• env为项目的环境标识
• version为项目版本
• userName为登录用户名
• options为扩展信息对象，选填

FunDebugUtil还有跟notify、notifyError方法

城市(省市区)工具

import { CityUtil } from 'lq-tool';

====== 1. cityDict ======
获取省市区字典数据。

CityUtil.cityDict;

====== 2. shapeCity ======
获取扁平化数据。

CityUtil.shapeCity(<value>, <deep>);

• value默认为空，设'id'会改变输入的value属性取值
• deep为取到哪一层数据，如为2取到省和市的数据

====== 3. treeCity ======
获取树形化数据。

CityUtil.treeCity(<value>, <deep>);

• value默认为空，设'id'会改变输入的value属性取值
• deep为取到哪一层数据，如为2取到省和市的数据

====== 4. findChildren ======
根据父ID获取子数据。

CityUtil.findChildren(<pid>);

• pid默认空，返回省数据； =======

2018-01-22变更

将fundebug的包fundebug-javascript包的版本由0.3.3更新到0.3.4。 fundebug的使用需要将og6593g2z.qnssl.com替换为js.fundebug.cn。 Chrome 66拉黑Symantec证书在2018年4月17号。

common-tool包升级到1.1.19。