xmcommon

一个js 通用库, 将一些常用的函数之类的，移到这里方便使用

- 使用typescript重写的1.0版正式发布。

- github: https://github.com/zdhsoft/xmcommon
- npm: https://www.npmjs.com/package/xmcommon

安装

npm install xmcommon

主要模块说明

- datetimeUtils 日期时间相关的处理工具函数
- utils 一些常用的工具类函数
- watchRequire 监控文化变化的函数
- SimpleCode 一种换位加编码的类
- getLogger 取日志对象的函数
- setGetLogger 设置getLogger函数的函数，用于替换现有的getLogger函数
- codeUtils 一些编码相关的函数，有md5，sha254，base64等函数
- error_common, error_utils 通用错误信息和错误相关函数
- common_ret 通用返回的类
- bitUtils 二进制标志的工具类
- CNYCurrency 中文货币类
- list_sturct 包含了队列和堆栈的简单实现。

版本变更说明

1.1.0

- \+ 增加从公元元年到当前时间的天数的函数
- \+ 增加isSampleDate与isBaseDate两个函数
- \+ 增加一组常用正则表达式定义
- \+ 增加一个isObjectLike方法（来源于lodash)
- \+ 更新依赖库
- \+ 开始增加jest库，用于编写测试用例
- \+ 删除buffer相关的未完善的实现可以使用xmbuffer这个库:https://www.npmjs.com/package/xmbuffer
- \+ 对货币类和codeutils, list结构进行单元测试
- \* 优化baseDate正则表达式
- \+ 增加枚举工具类
- \+ 增加excel表中，日期整数转日期的功能 isExcelDate

1.0.9

- \* 升级单元测试的mocha的版本
- \* 优化货币类，增加读取带千分位的金额
- \* 增加typesript的重载函数
- \+ utils增加getMapkeys,getMapValues,getMapKeyValues,getSetKeys等函数

1.0.8 2022-07-20

- 优化工程项目
- 修复vscode下，无代码提示的bug.

1.0.7 2022-07-12

- 增加enum YesOrNo枚举
- 增加TOptions类型

1.0.6 2022-07-11

- 增加MD5FromStringList,MD5FromBufferList,MD5FromBuffer三个方法

1.0.5 2022-07-08

- 增加isEmpty和isTrueEmpty的方法，这个方法和thinkjs中对应的方法的作用是一样的
- 将一些isXXX的函数，引用lodash或js自带的，不再封装一次，直接引用了
- 日志增加msg接口，用于专门写收发消息文件

1.0.3 2022-04-14

- \* 将一些用不到的函数以及类标注为deprecated，还会保留，在2.0的时候会删除
- \* 这里的utils,datetimeUtils,watchRequire,common_ret，CNYCurrency等已经常过了常时间的使用，暂无问题，可以放心使用了

0.9.21 2022-3-2

- \+ utils增加calcPageOffsetByPageInfo，calcPageOffset，notNullEmptyString三个函数

0.9.20 2022-2-24

- \* 修改fileExistsSync描述错误

0.9.19 2022-2-23

- \+ utils增加isDirSync, isFileSync方法
- \* 更新依赖库的版本

0.9.18 2022-01-23

- \+ 增加基于数组实现的Queue和Stack两个类

0.9.17 2022-01-22

- \+ utils增加一组选项默认值方法 stringOpts, intOpts, numberOpts, boolOpts, objectOpts, 当传入参数不是指定类型时，会返回默认值
- \+ utils增加一个方法limitString，超过指定的长度，会自动截取指定的长度

0.9.16 2022-01-07

- \+ 给common_ret增加assignFrom方法
- \+ 增加ICommonRetBase的定义
- \- 删除datatimeUtils的version方法
- \+ datetimeUtils增加getDateString和getTimeString方法

0.9.15 2022-01-05

- \* 更新依赖库的版本
- \* 优化utils.formatNumber函数

0.9.14 2022-01-05

- \+ 增加utils.calcMaxPage方法
- \+ 增加utils.roundPageInfo方法

0.9.13 2021-12-02

- \* 将一些any类型改为unknown类型

0.9.12 2021-11-29

- \* CNYCurrency类的format方法，增加无千分位分隔符的参数

0.9.11 2021-11-16

- \* 使用prettier格式化代码
- \* 使用eslint对代码进行检查

0.9.10 2021-11-15

- \* 修复shortpath的bug

0.9.8 2021-11-15

- \* 优化日志管理类，增加创建接口和设置猫缺省接口。

0.9.7 2021-11-12

- \+ 日志增加log方法
- \* 更新部分依赖包

0.9.6 2021-09-29

- \* 修改common_ret和XCommonRet的设置error的参数类型定义为number

0.9.5 2021-09-28

- \* 增加类的导出

0.9.4 2021-09-28

- \* 更新readme.md

0.9.3 2021-09-28

- \+ 增加一个XCommonRet替代common_ret，主要不是支持泛型

0.9.2 2021-09-05

- \+ 增加一个BufferWapper类

0.9.1 2021-09-03

- \* 解决不能引入的问题

0.9.0 2021-09-02

- \* 将通用库使用typescript改写，改写量比较大，还没有全面的测试，这个版本请慎用，请尽量用0.1.9这个版本。
- \* 增加一些单元测试例子

0.1.9 2021-05-08

- \* 依赖的lodash库，出现安全警告，在这里更新依赖库

0.1.8 2021-04-28

- \- 标注httpcall为@deprecated 计划在未来的版中，准备删除这个
- \* 为common_ret增加toString等方法内容。

0.1.7 2020-12-24

- \+ 增加fileExists判断文件或目录是否存在
- \* 修复makedirs存在的bug
- \+ 增加renameFile方法

0.1.4 2020-08-20

- \+ 增加watchRequire注意事项说明
- \* 更新lodash的库

0.1.3 2020-06-05

- \+ 增加utils.randomInteger,随机整数
- \+ 增加utils.randomScope,随机范围整数
- \+ 增加utils.randomBetween,随机整数，批定开始和结束值
- \* 更新依赖包的版本

0.1.2 2019-07-20

- \* 优化utils.formatPercentage生成成
- \+ 增加utils.roundPercentage，将百分比的值精度控制到 0.0001%

0.1.1 2019-07-14

- \* 收到github提示，说依赖的lodash有问题，所以这里升级一下 lodash , 还是高级别的
- \* We found a potential security vulnerability in one of your dependencies.

0.1.0 2019-07-14

- \* fixbug 修复utils.mkdirSync在linux下，使用绝对路径会失败的bug
- \+ 增加utils.mkdirSyncEx，用于返回具体的错误信息
- \+ 增加utils.formatPercentage，用于生成百分比字符串

0.0.22 2019-07-04

- \* 修改index.d.ts，增加允许默认值参数定义

0.0.21 2019-06-28

- \* fixbug: 不能正确识别增加CNYCurrency类型的对象
- \+ 增加CNYCurrency.isCurrency函数，判断是否是CNYCurrency类型
- \+ datetimeUtils增加比较日期的时间差函数

0.0.20 2019-06-26

- \* 原生成中文货币大写存在问题，重新找了一个新的版本替换来源:https://www.jb51.net/article/89661.htm
- \+ 增加多情况货币测试
- \* 修复乘除的bug, 对于自乘与自除，返回的是boolean，判断成功失败
- \* 优化人民币大写生成, 主要有小于1元的情况，分为0的时候，要加整
- \* 增加生成大写，index.d.ts定义

0.0.17 2019-06-24

- \* 增加CNYCurrency构造函数默认值0, 如果传入null或undefined也视为0, 测试CNYCurrency 1-100000000之间的值
- \+ CNYCurrency 增加assign赋值函数
- \* 将index.d.ts中的utils.JsonParse的定义返回值由{}改为any

0.0.16 2019-06-03

- \* 修复生成大写的bug，主要是百==>佰千==>仟

``

js

let m = [];

let c = new CNYCurrency(-12345);

m.push(c);

m.push(c.add(109999));

m.push(c.sub(10));

m.push(c.div(0.01));

m.push(c.mul(10));

m.push(c.mul(0.01));



let tt = new CNYCurrency(0);

tt.selfAdd(2805307.04);

tt.selfAdd(4323515.28);

tt.selfAdd(2805307.04);

tt.selfAdd(3281107.13);

m.push(tt);





for(let mm of m) {

    console.log(mm.value, mm.intValue, mm.toString(), mm.format(true, true), mm.Chinese());

}



//输出结果

//-12345 -1234500 -12345.00 ￥-1,2345.00 负壹万贰仟叁佰肆拾伍元整

//97654 9765400 97654.00 ￥9,7654.00 玖万柒仟陆佰伍拾肆元整

//-12355 -1235500 -12355.00 ￥-1,2355.00 负壹万贰仟叁佰伍拾伍元整

//-1234500 -123450000 -1234500.00 ￥-123,4500.00 负壹佰贰拾叁万肆仟伍佰元整

//-123450 -12345000 -123450.00 ￥-12,3450.00 负拾贰万叁仟肆佰伍拾元整

//-123.45 -12345 -123.45 ￥-123.45 负壹佰贰拾叁元肆角伍分

//13215236.49 1321523649 13215236.49 ￥1321,5236.49 壹仟叁佰贰拾壹万伍仟贰佰叁拾陆元肆角玖分





0.0.15 2019-06-01

- \+ 增加CNYCurrency 中文货币类



0.0.14 2019-04-20

- \* 优化index.d.ts部分注释, 将object变化any, 将[string]变化string[] 这样在typescript的可以正常使用

- \+ codeUtils增加MD5FromArgs

- \+ CHttpCall 增加 asyncJsonPost 和 asyncJsonGet方法



0.0.13 2019-03-28

- \* 优化index.d.ts部分注释

- \+ utils增加options对参数解析的方法  用于node启动后，传入参数的接收处理

js

let {utils} = require("../lib/utils");

let v = ["../tt", "--env", "aaaaa", "--version", "1.0.0", "aaaaa", "--flag", "true", "-aaaaa"];

let k = utils.options(v);

console.log(JSON.stringify(k, null, 2));

//对于参数接收用  let k = utils.options(process.argv);





运行结果

json

{

  "_": [

    "../tt",

    "aaaaa",

    "-aaaaa"

  ],

  "args": {

    "env": "aaaaa",

    "version": "1.0.0",

    "flag": "true"

  }

}





0.0.12 2019-02-18

- \+ 修改readme.md说明



0.0.10 2019-02-18

- \+ 增加index.d.ts，使用的时候，可以在vscode有代码提示说明了



0.0.9 2019-02-10

- \+ datetimeUtils 增加diffLocalDays，CalcLocalDaysByUTC，CalcLocalDaysByDate等函数

- \+ datetimeUtils 修改getNow()的描述错误

- \+ datetimeUtils 增加getLocalNow()和getLocalNowSecond()



0.0.8 2018-12-21

- \+ datetimeUtils 补全上次未能提交的函数



0.0.7 2018-12-12

- \+ datetimeUtils 增加了ToLocalTime,ToUTCTime,getTodayZeroTime,isSameDay等函数



0.0.6 2018-11-01

- \+ 增加了bitUtil对整数位处理函数，可以用于标志位处理

- \+ 增加utils中的ToInteger, ToFloat, JsonParse和mkdirsSync等几个函数



0.0.5 2018-10-31

- \* 更新依赖包 lodash 4.17.10 -->4.17.11



0.0.4 2018-10-31

- \+ 增加日志前缀缩短处理

js

//文件:example/test.js

let comm = require("xmcommon");

let log = comm.getLogger(__filename);

log.info("hello world");

//[example\test 2018-10-31 19:29:09.802  INFO] hello world

0.0.3

- 初始版本