tools-for-js 1.3.1 → 1.4.0

package/README.md

@@ -25,14 +25,13 @@ import { API } from 'tools-for-js'
 | 将对象中的键转小写                               | lowercaseKeys     |
 | 将对象中的键转大写                               | upperCaseKeys     |
 | 获取时间间隔                                     | getTimeDistance   |
-| 转换时间戳                                       | timeStamp         |
+| 获取时间戳                                       | timeStamp         |
 | 获取倒计时                                       | countDown         |
 | 距离当前时间状况                                 | transformDate     |
 | 变量类型判断                                     | IsType            |
 | 深拷贝变量                                       | deepCopy          |
 | 校验空值参数                                     | isEmpty           |
 | 校验两个参数是否相等                             | isEqual           |
-| 生成 UUID                                        | createUUID        |
 | 数组去重                                         | deWeightArray     |
 | 计算树的最后节点某字段的总和                     | treeLastChildSum  |
 | 校验数组对象中是否存在指定的字段为空             | checkKeyEmpty     |
@@ -55,4 +54,12 @@ import { API } from 'tools-for-js'
 | 将路径中的反斜杠字符 \ 替换为斜杠 /              | replacePath       |
 | 切割/获取文件名                                  | splitToFileName   |
 | 数组反选                                         | invertSelection   |
-| 生成随机颜色                                     | getRandomColor    |
+| 创建时间对象                                     | createDate        |
+| 获取结束时间                                     | getExpiresEndTime |
+| 判断是否过期                                     | isExpires         |
+| 随机数字                                         | randomNum         |
+| 随机字符串                                       | randomCode        |
+| 随机颜色                                         | randomColor       |
+| 创建 UUID                                        | createUUID        |
+| 随机 MAC 地址                                    | randomMac         |
+| 待更新                                           | function          |

package/lib/index.js

@@ -57,10 +57,16 @@ Object.defineProperty(exports, "countNumber", {
     return _calculate.countNumber;
   }
 });
+Object.defineProperty(exports, "createDate", {
+  enumerable: true,
+  get: function get() {
+    return _time.createDate;
+  }
+});
 Object.defineProperty(exports, "createUUID", {
   enumerable: true,
   get: function get() {
-    return _common.createUUID;
+    return _random.createUUID;
   }
 });
 Object.defineProperty(exports, "dateFormat", {
@@ -93,16 +99,22 @@ Object.defineProperty(exports, "formatDate", {
     return _time.formatDate;
   }
 });
-Object.defineProperty(exports, "getPagination", {
+Object.defineProperty(exports, "getAfterNDays", {
   enumerable: true,
   get: function get() {
-    return _array.getPagination;
+    return _time.getAfterNDays;
+  }
+});
+Object.defineProperty(exports, "getExpiresEndTime", {
+  enumerable: true,
+  get: function get() {
+    return _time.getExpiresEndTime;
   }
 });
-Object.defineProperty(exports, "getRandomColor", {
+Object.defineProperty(exports, "getPagination", {
   enumerable: true,
   get: function get() {
-    return _string.getRandomColor;
+    return _array.getPagination;
   }
 });
 Object.defineProperty(exports, "getStrLength", {
@@ -141,6 +153,12 @@ Object.defineProperty(exports, "isEqual", {
     return _common.isEqual;
   }
 });
+Object.defineProperty(exports, "isExpires", {
+  enumerable: true,
+  get: function get() {
+    return _time.isExpires;
+  }
+});
 Object.defineProperty(exports, "lowercaseKeys", {
   enumerable: true,
   get: function get() {
@@ -165,6 +183,30 @@ Object.defineProperty(exports, "objectToQs", {
     return _object.objectToQs;
   }
 });
+Object.defineProperty(exports, "randomCode", {
+  enumerable: true,
+  get: function get() {
+    return _random.randomCode;
+  }
+});
+Object.defineProperty(exports, "randomColor", {
+  enumerable: true,
+  get: function get() {
+    return _random.randomColor;
+  }
+});
+Object.defineProperty(exports, "randomMac", {
+  enumerable: true,
+  get: function get() {
+    return _random.randomMac;
+  }
+});
+Object.defineProperty(exports, "randomNum", {
+  enumerable: true,
+  get: function get() {
+    return _random.randomNum;
+  }
+});
 Object.defineProperty(exports, "replacePath", {
   enumerable: true,
   get: function get() {
@@ -237,4 +279,5 @@ var _array = require("./utils/array");
 var _calculate = require("./utils/calculate");
 var _common = require("./utils/common");
 var _string = require("./utils/string");
+var _random = require("./utils/random");
 var _object = require("./utils/object");

package/lib/utils/common.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.isEqual = exports.isEmpty = exports.deepCopy = exports.createUUID = exports.IsType = void 0;
+exports.isEqual = exports.isEmpty = exports.deepCopy = exports.IsType = void 0;
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 /*******
  * @description: 变量类型判断
@@ -112,29 +112,4 @@ var isEqual = exports.isEqual = function isEqual(a, b) {
     return false; // 其它类型,均返回false
   }
   return true;
-};
-
-/*******
- * @description: 生成UUID
- * UUID(Universally Unique IDentifier) 全局唯一标识符。
- * UUID是一种由算法生成的二进制长度为128位的数字标识符。
- * UUID的格式为“xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”，
- * 其中的 x 是 0-9 或 a-f 范围内的一个32位十六进制数。
- * 在理想情况下，任何计算机和计算机集群都不会生成两个相同的UUID。
- * @author: 琴时
- * @param {String} symbol [分隔符] [默认为空]
- * @return {String}
- * @example: createUUID('-') // 生成UUID并使用[-]作为分隔符
- */
-var createUUID = exports.createUUID = function createUUID() {
-  var symbol = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : '';
-  var s = [];
-  var hexDigits = '0123456789abcdef';
-  for (var i = 0; i < 36; i++) {
-    s[i] = hexDigits.substr(Math.floor(Math.random() * 0x10), 1);
-  }
-  s[14] = '4'; // bits 12-15 of 时间和版本字段设置为0010
-  s[19] = hexDigits.substr(s[19] & 0x3 | 0x8, 1); // bits 6-7 of the clock_seq_hi_and_reserved to 01
-  s[8] = s[13] = s[18] = s[23] = '-';
-  return s.join('').replace(/-/g, symbol);
 };

package/lib/utils/random.js

@@ -0,0 +1,100 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.randomCode = exports.createUUID = void 0;
+exports.randomColor = randomColor;
+exports.randomNum = exports.randomMac = void 0;
+/*******
+ * @description: 随机数字
+ * @author: 琴时
+ * @param {Number} length [长度] [默认为6]
+ * @return {String}
+ */
+var randomNum = exports.randomNum = function randomNum() {
+  var length = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 6;
+  var result = '';
+  var decimalDigits = '0123456789';
+  for (var i = 0; i < length; i++) {
+    var index = Math.floor(Math.random() * 10); //随机生成一位0~9的数
+    result += decimalDigits.charAt(index);
+  }
+  return result;
+};
+
+/*******
+ * @description: 随机字符串
+ * @author: 琴时
+ * @param {Number} length [长度] [默认为6]
+ * @return {String}
+ */
+var randomCode = exports.randomCode = function randomCode() {
+  var length = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 6;
+  var result = '';
+  var num = '0123456789';
+  var lower = 'abcdefghijklmnopqrstuvwxyz';
+  var capital = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+  var character = num + lower + capital;
+  for (var i = 0; i < length; i++) {
+    var index = Math.floor(Math.random() * character.length); //随机生成一位0~61的数
+    result += character.charAt(index);
+  }
+  return result;
+};
+
+/*******
+ * @description: 随机颜色
+ * @author: 琴时
+ * @param {Array} exclude [跳过颜色(可选参数)，默认为空数组]
+ * @return {String}
+ */
+function randomColor() {
+  var exclude = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
+  var hexDigits = '0123456789ABCDEF';
+  var color = '#';
+  for (var i = 0; i < 6; i++) {
+    var index = Math.floor(Math.random() * 16); //随机生成一位0~15的数
+    color += hexDigits.charAt(index);
+  }
+  //如果生成的颜色和默认颜色重复了，则重新生成
+  if (exclude.includes(color)) randomColor(exclude);
+  return color;
+}
+
+/*******
+ * @description: 创建UUID
+ * UUID(Universally Unique IDentifier) 全局唯一标识符。
+ * UUID是一种由算法生成的二进制长度为128位的数字标识符。
+ * UUID的格式为“xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx”，
+ * 其中的 x 是 0-9 或 a-f 范围内的一个32位十六进制数。
+ * 在理想情况下，任何计算机和计算机集群都不会生成两个相同的UUID。
+ * @author: 琴时
+ * @param {String} symbol [分隔符] [默认为空]
+ * @return {String}
+ * @example: createUUID('-') // 生成UUID并使用[-]作为分隔符
+ */
+var createUUID = exports.createUUID = function createUUID() {
+  var symbol = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : '-';
+  var s = [];
+  var hexDigits = '0123456789abcdef';
+  for (var i = 0; i < 36; i++) {
+    s[i] = hexDigits.charAt(Math.floor(Math.random() * 16));
+  }
+  s[14] = '4'; // bits 12-15 of 时间和版本字段设置为0010
+  s[19] = hexDigits.charAt(s[19] & 3 | 8); // bits 6-7 of the clock_seq_hi_and_reserved to 01
+  s[8] = s[13] = s[18] = s[23] = '-';
+  return s.join('').replace(/-/g, symbol);
+};
+
+/*******
+ * @description: 随机MAC地址
+ * @author: 琴时
+ * @return {String}
+ */
+var randomMac = exports.randomMac = function randomMac() {
+  return 'XX:XX:XX:XX:XX:XX'.replace(/X/g, function () {
+    var hexDigits = '0123456789ABCDEF';
+    return hexDigits.charAt(Math.floor(Math.random() * 16));
+  });
+};

package/lib/utils/string.js

@@ -3,9 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.encode = exports.decode = exports.checkPwdStrength = void 0;
-exports.getRandomColor = getRandomColor;
-exports.getStrLength = void 0;
+exports.getStrLength = exports.encode = exports.decode = exports.checkPwdStrength = void 0;
 exports.replacePath = replacePath;
 exports.splitString = splitString;
 exports.splitToFileName = splitToFileName;
@@ -208,22 +206,4 @@ function splitToFileName(path) {
   var lastIndex = path.lastIndexOf('/');
   if (lastIndex === -1) return path;
   return path.substring(lastIndex + 1);
-}
-
-/*******
- * @description: 生成随机颜色
- * @author: 琴时
- * @param {Array} defaultList [跳过颜色(可选参数)，默认为空数组]
- * @return {String}
- */
-function getRandomColor() {
-  var defaultList = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : [];
-  var letters = '0123456789ABCDEF';
-  var color = '#';
-  for (var i = 0; i < 6; i++) {
-    color += letters[Math.floor(Math.random() * 16)];
-  }
-  //如果生成的颜色和默认颜色重复了，则重新生成
-  if (defaultList.includes(color)) getRandomColor(defaultList);
-  return color;
 }

package/lib/utils/time.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.transformDate = exports.timeStamp = exports.getTimeDistance = exports.formatDate = exports.dateFormat = exports.countDown = void 0;
+exports.transformDate = exports.timeStamp = exports.isExpires = exports.getTimeDistance = exports.getExpiresEndTime = exports.getAfterNDays = exports.formatDate = exports.dateFormat = exports.createDate = exports.countDown = void 0;
 require("dayjs/locale/zh-cn");
 var _relativeTime = _interopRequireDefault(require("dayjs/plugin/relativeTime"));
 var _dayjs = _interopRequireDefault(require("dayjs"));
@@ -13,28 +13,47 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
 _dayjs["default"].locale('zh-cn'); // 全局使用
 
 /*******
- * @description: 生成时间格式化
+ * @description: 创建时间对象
  * @author: 琴时
- * @param {date} 需要格式化的时间串（''/null/undefined ==> 默认当前时间）
- * @param {fmt} 格式化样式标识（年-月-日：YYYY-MM-DD）(不传默认返回年-月-日 时:分:秒)
- * @return {*} 返回格式化后的时间字符串
+ * @param {*} date [时间戳|时间字符串|时间对象|或者为空]
+ * @return {Date}
  */
-var dateFormat = exports.dateFormat = function dateFormat(date) {
-  var fmt = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'YYYY-MM-DD HH:mm:ss';
+var createDate = exports.createDate = function createDate(date) {
   var pattern = /^(?=.*T)(?=.*).*$/;
   var patternNum = /^\d*$/;
-  if (!date) {
-    // 不传参数
-    date = new Date();
-  } else if (patternNum.test(date)) {
+  if (!date) return new Date(); // 不传参数
+  if (patternNum.test(date)) {
     // 时间戳
     date = parseInt(date);
   } else if (typeof date === 'string' && !pattern.test(date)) {
     //兼容ios: 将时间字符串中的'-'替换成'/' 2021-05-20 00:00:00=>2021/05/20 00:00:00
     date = "".concat(date).replace(/-/g, '/');
   }
-  /* 处理格式化时间 */
-  var dt = new Date(date); //创建时间对象
+  return new Date(date);
+};
+
+/*******
+ * @description: 获取时间戳
+ * @author: 琴时
+ * @param {*}  date [时间字符串]/[时间对象]
+ * @return {Number} [时间戳]
+ */
+var timeStamp = exports.timeStamp = function timeStamp(date) {
+  // const date = +new Date(date) //转换成时间戳
+  // const newDate = Date.now() //H5-生成当前时间戳
+  return createDate(date).getTime();
+};
+
+/*******
+ * @description: 生成时间格式化
+ * @author: 琴时
+ * @param {date} 需要格式化的时间串（''/null/undefined ==> 默认当前时间）
+ * @param {fmt} 格式化样式标识（年-月-日：YYYY-MM-DD）(不传默认返回年-月-日 时:分:秒)
+ * @return {*} 返回格式化后的时间字符串
+ */
+var dateFormat = exports.dateFormat = function dateFormat(date) {
+  var fmt = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'YYYY-MM-DD HH:mm:ss';
+  var dt = createDate(date); //创建时间对象
   // 构造正则匹配:(value)padStart:字符串不满2位数,开头补全'0'
   var o = {
     '[Yy]+': dt.getFullYear(),
@@ -71,20 +90,21 @@ var formatDate = exports.formatDate = function formatDate(date) {
 /*******
  * @description: 获取时间间隔
  * @author: 琴时
- * @param {start_Time} [开始时间]
- * @param {end_Time} [结束时间]
+ * @param {*} st [开始时间]
+ * @param {*} et [结束时间]
+ * @param {String} key [索引]
  * @return {*} 处理好的时间间隔相关对象
  */
-var getTimeDistance = exports.getTimeDistance = function getTimeDistance(start_Time, end_Time) {
-  var startTime = +new Date(start_Time); // 开始时间戳
-  var endTime = +new Date(end_Time); // 结束时间戳
-  var times = (endTime - startTime) / 1000; // 剩余时间总的秒数
+var getTimeDistance = exports.getTimeDistance = function getTimeDistance(st, et, key) {
+  st = timeStamp(st); // 开始时间戳
+  et = timeStamp(et); // 结束时间戳
+  var times = (et - st) / 1000; // 剩余时间总的秒数
   var dd = parseInt(times / 60 / 60 / 24).toString().padStart(2, '0'); //天
   var hh = parseInt(times / 60 / 60 % 24 + '').toString().padStart(2, '0'); //时
   var mm = parseInt(times / 60 % 60 + '').toString().padStart(2, '0'); //分
   var ss = parseInt(times % 60 + '').toString().padStart(2, '0'); //秒
   if (ss < 0 || mm < 0 || hh < 0 || dd < 0) return null;
-  return {
+  var obj = {
     timeStr: "".concat(dd, "\u5929").concat(hh, "\u65F6").concat(mm, "\u5206").concat(ss, "\u79D2"),
     timeStamp: times,
     //剩余时间秒数
@@ -100,35 +120,21 @@ var getTimeDistance = exports.getTimeDistance = function getTimeDistance(start_T
     //30天内
     year: dd > 0 && dd < 365 //一年内
   };
-};
-
-/*******
- * @description: 转换时间戳
- * @author: 琴时
- * @param {*}  params [时间字符串]/[时间对象]
- * @return {*} [时间戳,当前时间戳]
- */
-/*  */
-var timeStamp = exports.timeStamp = function timeStamp(params) {
-  var date = +new Date(params); //转换成时间戳
-  var newDate = Date.now(); //H5-生成当前时间戳
-  return {
-    date: date,
-    newDate: newDate
-  };
+  return obj[key] || obj;
 };
 
 /*******
  * @description: 倒计时
  * @author: 琴时
- * @param {params} [截止时间]
- * @return {*} [倒计时间/结束将返回null]
+ * @param {*} date [截止时间]
+ * @param {String} key [索引]
+ * @return {*} [倒计时间|结束则返回null]
  */
-var countDown = exports.countDown = function countDown(params) {
-  var sign = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'cn';
-  var nowTime = +new Date(); // 当前时间戳
-  var endTime = +new Date(params); // 结束时间戳
-  var times = (endTime - nowTime) / 1000; // 剩余时间总的秒数
+var countDown = exports.countDown = function countDown(date) {
+  var key = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'cn';
+  var nt = +new Date(); // 当前时间戳
+  date = timeStamp(date); // 结束时间戳
+  var times = (date - nt) / 1000; // 剩余时间总的秒数
   var dd = parseInt(times / 60 / 60 / 24).toString().padStart(2, '0'); // 天
   var hh = parseInt(times / 60 / 60 % 24 + '').toString().padStart(2, '0'); //时
   var mm = parseInt(times / 60 % 60 + '').toString().padStart(2, '0'); // 分
@@ -136,9 +142,9 @@ var countDown = exports.countDown = function countDown(params) {
   if (times <= 0) return null; //结束返回null
   var result = {
     cn: "".concat(dd, "\u5929").concat(hh, "\u65F6").concat(mm, "\u5206").concat(ss, "\u79D2"),
-    ss: parseInt(times)
+    ss: parseInt(times) //剩余时间秒数
   };
-  return result[sign];
+  return result[key];
 };
 
 /*******
@@ -165,4 +171,46 @@ var transformDate = exports.transformDate = function transformDate(date, diff) {
     }
   }
   return transDay;
+};
+
+/*******
+ * @description: 获取结束时间
+ * @author: 琴时
+ * @param {*} startTime [开始时间]
+ * @param {*} expires   [有效期/秒]
+ * @return {Date}
+ */
+var getExpiresEndTime = exports.getExpiresEndTime = function getExpiresEndTime(st, expires) {
+  st = timeStamp(st); //开始时间戳
+  expires = expires * 1000; //有效期毫秒
+  return new Date(st + expires);
+};
+
+/*******
+ * @description: 判断是否过期
+ * @author: 琴时
+ * @param {*} st [开始时间]
+ * @param {*} et  [当前时间]
+ * @param {*} expires   [有效期/毫秒]
+ * @return {*} [过期:true|未过期:false]
+ */
+var isExpires = exports.isExpires = function isExpires(st, et, expires) {
+  if (!st || !et || !expires) return true; // 参数不完整默认过期
+  st = timeStamp(st); //开始时间戳
+  et = timeStamp(et); // 结束时间戳
+  var differTime = et - st; //间隔毫秒
+  // 如果间隔毫秒 >= 有效期毫秒，则过期
+  return differTime >= expires;
+};
+
+/*******
+ * @description: 计算指定时间到间隔n天的时间
+ * @author: 琴时
+ * @param {*} date   [指定时间]
+ * @param {number} severalDays [间隔天数]
+ * @return {Date}
+ */
+var getAfterNDays = exports.getAfterNDays = function getAfterNDays(date, severalDays) {
+  date = timeStamp(date); //指定时间的时间戳
+  return new Date(date + severalDays * 24 * 60 * 60 * 1000);
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tools-for-js",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "基于babel构建的javascript工具库",
   "main": "lib/index.js",
   "scripts": {