tools-for-js 1.3.1 → 1.3.2

package/README.md

@@ -25,7 +25,7 @@ import { API } from 'tools-for-js'
 | 将对象中的键转小写                               | lowercaseKeys     |
 | 将对象中的键转大写                               | upperCaseKeys     |
 | 获取时间间隔                                     | getTimeDistance   |
-| 转换时间戳                                       | timeStamp         |
+| 获取时间戳                                       | timeStamp         |
 | 获取倒计时                                       | countDown         |
 | 距离当前时间状况                                 | transformDate     |
 | 变量类型判断                                     | IsType            |
@@ -56,3 +56,7 @@ import { API } from 'tools-for-js'
 | 切割/获取文件名                                  | splitToFileName   |
 | 数组反选                                         | invertSelection   |
 | 生成随机颜色                                     | getRandomColor    |
+| 创建时间对象                                     | createDate        |
+| 获取结束时间                                     | getExpiresEndTime |
+| 判断是否过期                                     | isExpires         |
+| 计算指定时间到间隔 n 天的时间                    | getAfterNDays     |

package/lib/index.js

@@ -57,6 +57,12 @@ 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() {
@@ -93,6 +99,18 @@ Object.defineProperty(exports, "formatDate", {
     return _time.formatDate;
   }
 });
+Object.defineProperty(exports, "getAfterNDays", {
+  enumerable: true,
+  get: function get() {
+    return _time.getAfterNDays;
+  }
+});
+Object.defineProperty(exports, "getExpiresEndTime", {
+  enumerable: true,
+  get: function get() {
+    return _time.getExpiresEndTime;
+  }
+});
 Object.defineProperty(exports, "getPagination", {
   enumerable: true,
   get: function get() {
@@ -141,6 +159,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() {

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.3.2",
   "description": "基于babel构建的javascript工具库",
   "main": "lib/index.js",
   "scripts": {