tools-min-ns 1.13.0 → 1.14.1

package/README.md

@@ -5,6 +5,11 @@ cnpm i tools-min-ns --save
 ```
 
 # updates
+## v1.14.1
+> DateUtil 日期格式化兼容YYYY-MM-DD
+
+## v1.14.0
+> ArrayUtil 新增三个分组方法
 ## v1.13.0
 > RequestUtil
 - handleRequests 中onUploadProgress新增两个参数nowResponse: T; endResponses: T[]

package/esm/array/ArrayUtil.d.ts

@@ -135,5 +135,43 @@ console.log(universalSort(objArray, obj => obj.name.length)); // [{ name: 'Jim',
 console.log(universalSort([5, 3, 8, 1, 2], null, 'desc')); // [8, 5, 3, 2, 1]
      */
     function universalSort<T>(array: T[], key?: keyof T | ((item: T) => any), order?: 'asc' | 'desc'): T[];
+    /**
+     * 根据对象的属性值进行分组
+     * @param array 对象数组
+     * @param key 对象的key
+     * @example
+const data = [
+  { name: 'Alice', age: 21 },
+  { name: 'Bob', age: 25 },
+  { name: 'Charlie', age: 21 },
+  { name: 'David', age: 25 }
+];
+
+const groupedByAge = groupBy(data, 'age');
+console.log(groupedByAge);  // {21: Array(2), 25: Array(2)}
+     */
+    function groupBy<T>(array: T[], key: keyof T): Record<keyof T, T[]>;
+    /**
+     * 按条件分组
+     * @param array 对象数组
+     * @param condition filter
+     * @example
+const numbers: number[] = [1, 2, 3, 4, 5, 6];
+
+const groupedByOddEven = groupByCondition(numbers, num => num % 2 === 0);
+console.log(groupedByOddEven); // {false: Array(3), true: Array(3)}
+     */
+    function groupByCondition<T>(array: T[], condition: (value: T) => boolean): Record<'true' | 'false', T[]>;
+    /**
+     * 按固定大小分组
+     * @param array 对象数组
+     * @param size 数量
+     * @example
+const data: number[] = [1, 2, 3, 4, 5, 6, 7, 8, 9];
+
+const chunkedArray = chunkArray(data, 3);
+console.log(chunkedArray);// [Array(3), Array(3), Array(3)]
+     */
+    function chunkArray<T>(array: T[], size: number): T[][];
 }
 export default ArrayUtil;

package/esm/array/ArrayUtil.js

@@ -309,5 +309,67 @@ var ArrayUtil;
     return array.sort(compareFunction);
   }
   ArrayUtil.universalSort = universalSort;
+  /**
+   * 根据对象的属性值进行分组
+   * @param array 对象数组
+   * @param key 对象的key
+   * @example
+  const data = [
+  { name: 'Alice', age: 21 },
+  { name: 'Bob', age: 25 },
+  { name: 'Charlie', age: 21 },
+  { name: 'David', age: 25 }
+  ];
+  const groupedByAge = groupBy(data, 'age');
+  console.log(groupedByAge);  // {21: Array(2), 25: Array(2)}
+   */
+  function groupBy(array, key) {
+    return array.reduce(function (result, currentValue) {
+      var groupKey = currentValue[key];
+      if (!result[groupKey]) {
+        result[groupKey] = [];
+      }
+      result[groupKey].push(currentValue);
+      return result;
+    }, {});
+  }
+  ArrayUtil.groupBy = groupBy;
+  /**
+   * 按条件分组
+   * @param array 对象数组
+   * @param condition filter
+   * @example
+  const numbers: number[] = [1, 2, 3, 4, 5, 6];
+  const groupedByOddEven = groupByCondition(numbers, num => num % 2 === 0);
+  console.log(groupedByOddEven); // {false: Array(3), true: Array(3)}
+   */
+  function groupByCondition(array, condition) {
+    return array.reduce(function (result, currentValue) {
+      var groupKey = condition(currentValue) ? 'true' : 'false';
+      if (!result[groupKey]) {
+        result[groupKey] = [];
+      }
+      result[groupKey].push(currentValue);
+      return result;
+    }, {});
+  }
+  ArrayUtil.groupByCondition = groupByCondition;
+  /**
+   * 按固定大小分组
+   * @param array 对象数组
+   * @param size 数量
+   * @example
+  const data: number[] = [1, 2, 3, 4, 5, 6, 7, 8, 9];
+  const chunkedArray = chunkArray(data, 3);
+  console.log(chunkedArray);// [Array(3), Array(3), Array(3)]
+   */
+  function chunkArray(array, size) {
+    var result = [];
+    for (var i = 0; i < array.length; i += size) {
+      result.push(array.slice(i, i + size));
+    }
+    return result;
+  }
+  ArrayUtil.chunkArray = chunkArray;
 })(ArrayUtil || (ArrayUtil = {}));
 export default ArrayUtil;

package/esm/date/DateUtil.d.ts

@@ -38,13 +38,13 @@ declare namespace DateUtil {
     /**
      * 将日期格式化成指定格式的字符串
      * @param {Date | Number | String} date 要格式化的日期，不传时默认当前时间，也可以是一个时间戳/字符串
-     * @param {String} format 目标字符串格式，支持的字符有：y,M,d,q,w,H,h,m,S，默认：yyyy-MM-dd HH:mm:ss
+     * @param {String} format 目标字符串格式，支持的字符有：y,Y,M,d,D,q,w,H,h,m,S，默认：yyyy-MM-dd HH:mm:ss
      * @returns {String} 返回格式化后的日期字符串，日期不合法时返回字符串 'invalid date'
      * @example
      *  formatDate(); => 2016-09-02 13:17:13
      *  formatDate('2016-09-02','yyyy年MM月dd日'); => 2016年09月02日
      *  formatDate(new Date(), 'yyyy-MM-dd'); => 2016-09-02
-     *  formatDate(new Date(), 'yyyy-MM-dd 第q季度 www HH:mm:ss:SSS'); => 2016-09-02 第3季度 星期五 13:19:15:792
+     *  formatDate(new Date(), 'yyyy-MM-dd 第q季度 星期w HH:mm:ss:SSS'); => 2016-09-02 第3季度 星期五 13:19:15:792
      *  formatDate(1472793615764); => 2016-09-02 13:20:15
      */
     const formatDate: (date?: Date | number | string, format?: string) => string;

package/esm/date/DateUtil.js

@@ -65,7 +65,7 @@ var DateUtil;
     dateFormatRules.forEach(function (item) {
       for (var index = 0, rules = item.rules, len = rules.length; index < len; index++) {
         rule = rules[index];
-        sIndex = format.indexOf("".concat(rule[0]));
+        sIndex = format.replaceAll('D', 'd').replaceAll('Y', 'y').indexOf("".concat(rule[0]));
         if (sIndex !== -1) {
           dates.push(parseFloat(dateStr.substring(sIndex, sIndex + Number(rule[1]))) + (item.offset || 0));
           // 如果匹配到规则中的第一条，则退出
@@ -81,13 +81,13 @@ var DateUtil;
   /**
    * 将日期格式化成指定格式的字符串
    * @param {Date | Number | String} date 要格式化的日期，不传时默认当前时间，也可以是一个时间戳/字符串
-   * @param {String} format 目标字符串格式，支持的字符有：y,M,d,q,w,H,h,m,S，默认：yyyy-MM-dd HH:mm:ss
+   * @param {String} format 目标字符串格式，支持的字符有：y,Y,M,d,D,q,w,H,h,m,S，默认：yyyy-MM-dd HH:mm:ss
    * @returns {String} 返回格式化后的日期字符串，日期不合法时返回字符串 'invalid date'
    * @example
    *  formatDate(); => 2016-09-02 13:17:13
    *  formatDate('2016-09-02','yyyy年MM月dd日'); => 2016年09月02日
    *  formatDate(new Date(), 'yyyy-MM-dd'); => 2016-09-02
-   *  formatDate(new Date(), 'yyyy-MM-dd 第q季度 www HH:mm:ss:SSS'); => 2016-09-02 第3季度 星期五 13:19:15:792
+   *  formatDate(new Date(), 'yyyy-MM-dd 第q季度 星期w HH:mm:ss:SSS'); => 2016-09-02 第3季度 星期五 13:19:15:792
    *  formatDate(1472793615764); => 2016-09-02 13:20:15
    */
   DateUtil.formatDate = function (date, format) {
@@ -108,35 +108,38 @@ var DateUtil;
       return 'invalid date';
     }
     date = date;
-    var obj = {
+    var map = {
       y: date.getFullYear(),
+      Y: date.getFullYear(),
       M: date.getMonth() + 1,
       d: date.getDate(),
+      D: date.getDate(),
       q: Math.floor((date.getMonth() + 3) / 3),
-      w: date.getDay(),
+      w: ['日', '一', '二', '三', '四', '五', '六'][date.getDay()],
       H: date.getHours(),
       h: date.getHours() % 12 === 0 ? 12 : date.getHours() % 12,
       m: date.getMinutes(),
-      s: date.getSeconds(),
-      S: date.getMilliseconds() // 毫秒
+      S: date.getMilliseconds(),
+      s: date.getSeconds()
     };
-    var week = ['天', '一', '二', '三', '四', '五', '六'];
-    var _loop_1 = function _loop_1(i) {
-      format = format.replace(new RegExp(i + '+', 'g'), function (m) {
-        var val = "".concat(obj[i]);
-        if (i === 'w') {
-          return (m.length > 2 ? '星期' : '周') + week[Number(val)];
-        }
-        for (var j = 0, len = val.length; j < m.length - len; j++) {
-          val = '0' + val;
-        }
-        return m.length === 1 ? val : val.substring(val.length - m.length);
-      });
+    var formatNumber = function formatNumber(n) {
+      return n.toString().padStart(2, '0');
     };
-    for (var i in obj) {
-      _loop_1(i);
-    }
-    return format;
+    var formatMilliseconds = function formatMilliseconds(n) {
+      return n.toString().padStart(3, '0');
+    };
+    return format.replace(/(y+|Y+|M+|d+|D+|q+|w+|H+|h+|m+|s+|S+)/g, function (match) {
+      var char = match[0];
+      var result = map[char];
+      if (char.toLowerCase() === 'y') {
+        result = result.toString().substr(4 - match.length);
+      } else if (char === 'S') {
+        result = formatMilliseconds(result);
+      } else if (['M', 'd', 'D', 'H', 'h', 'm', 's'].includes(char)) {
+        result = formatNumber(result);
+      }
+      return result;
+    });
   };
   /**
    * 将一个日期格式化成友好格式，比如，1分钟以内的返回“刚刚”，

package/lib/array/ArrayUtil.d.ts

@@ -135,5 +135,43 @@ console.log(universalSort(objArray, obj => obj.name.length)); // [{ name: 'Jim',
 console.log(universalSort([5, 3, 8, 1, 2], null, 'desc')); // [8, 5, 3, 2, 1]
      */
     function universalSort<T>(array: T[], key?: keyof T | ((item: T) => any), order?: 'asc' | 'desc'): T[];
+    /**
+     * 根据对象的属性值进行分组
+     * @param array 对象数组
+     * @param key 对象的key
+     * @example
+const data = [
+  { name: 'Alice', age: 21 },
+  { name: 'Bob', age: 25 },
+  { name: 'Charlie', age: 21 },
+  { name: 'David', age: 25 }
+];
+
+const groupedByAge = groupBy(data, 'age');
+console.log(groupedByAge);  // {21: Array(2), 25: Array(2)}
+     */
+    function groupBy<T>(array: T[], key: keyof T): Record<keyof T, T[]>;
+    /**
+     * 按条件分组
+     * @param array 对象数组
+     * @param condition filter
+     * @example
+const numbers: number[] = [1, 2, 3, 4, 5, 6];
+
+const groupedByOddEven = groupByCondition(numbers, num => num % 2 === 0);
+console.log(groupedByOddEven); // {false: Array(3), true: Array(3)}
+     */
+    function groupByCondition<T>(array: T[], condition: (value: T) => boolean): Record<'true' | 'false', T[]>;
+    /**
+     * 按固定大小分组
+     * @param array 对象数组
+     * @param size 数量
+     * @example
+const data: number[] = [1, 2, 3, 4, 5, 6, 7, 8, 9];
+
+const chunkedArray = chunkArray(data, 3);
+console.log(chunkedArray);// [Array(3), Array(3), Array(3)]
+     */
+    function chunkArray<T>(array: T[], size: number): T[][];
 }
 export default ArrayUtil;

package/lib/array/ArrayUtil.js

@@ -319,5 +319,67 @@ var ArrayUtil;
     return array.sort(compareFunction);
   }
   ArrayUtil.universalSort = universalSort;
+  /**
+   * 根据对象的属性值进行分组
+   * @param array 对象数组
+   * @param key 对象的key
+   * @example
+  const data = [
+  { name: 'Alice', age: 21 },
+  { name: 'Bob', age: 25 },
+  { name: 'Charlie', age: 21 },
+  { name: 'David', age: 25 }
+  ];
+  const groupedByAge = groupBy(data, 'age');
+  console.log(groupedByAge);  // {21: Array(2), 25: Array(2)}
+   */
+  function groupBy(array, key) {
+    return array.reduce(function (result, currentValue) {
+      var groupKey = currentValue[key];
+      if (!result[groupKey]) {
+        result[groupKey] = [];
+      }
+      result[groupKey].push(currentValue);
+      return result;
+    }, {});
+  }
+  ArrayUtil.groupBy = groupBy;
+  /**
+   * 按条件分组
+   * @param array 对象数组
+   * @param condition filter
+   * @example
+  const numbers: number[] = [1, 2, 3, 4, 5, 6];
+  const groupedByOddEven = groupByCondition(numbers, num => num % 2 === 0);
+  console.log(groupedByOddEven); // {false: Array(3), true: Array(3)}
+   */
+  function groupByCondition(array, condition) {
+    return array.reduce(function (result, currentValue) {
+      var groupKey = condition(currentValue) ? 'true' : 'false';
+      if (!result[groupKey]) {
+        result[groupKey] = [];
+      }
+      result[groupKey].push(currentValue);
+      return result;
+    }, {});
+  }
+  ArrayUtil.groupByCondition = groupByCondition;
+  /**
+   * 按固定大小分组
+   * @param array 对象数组
+   * @param size 数量
+   * @example
+  const data: number[] = [1, 2, 3, 4, 5, 6, 7, 8, 9];
+  const chunkedArray = chunkArray(data, 3);
+  console.log(chunkedArray);// [Array(3), Array(3), Array(3)]
+   */
+  function chunkArray(array, size) {
+    var result = [];
+    for (var i = 0; i < array.length; i += size) {
+      result.push(array.slice(i, i + size));
+    }
+    return result;
+  }
+  ArrayUtil.chunkArray = chunkArray;
 })(ArrayUtil || (ArrayUtil = {}));
 exports.default = ArrayUtil;

package/lib/date/DateUtil.d.ts

@@ -38,13 +38,13 @@ declare namespace DateUtil {
     /**
      * 将日期格式化成指定格式的字符串
      * @param {Date | Number | String} date 要格式化的日期，不传时默认当前时间，也可以是一个时间戳/字符串
-     * @param {String} format 目标字符串格式，支持的字符有：y,M,d,q,w,H,h,m,S，默认：yyyy-MM-dd HH:mm:ss
+     * @param {String} format 目标字符串格式，支持的字符有：y,Y,M,d,D,q,w,H,h,m,S，默认：yyyy-MM-dd HH:mm:ss
      * @returns {String} 返回格式化后的日期字符串，日期不合法时返回字符串 'invalid date'
      * @example
      *  formatDate(); => 2016-09-02 13:17:13
      *  formatDate('2016-09-02','yyyy年MM月dd日'); => 2016年09月02日
      *  formatDate(new Date(), 'yyyy-MM-dd'); => 2016-09-02
-     *  formatDate(new Date(), 'yyyy-MM-dd 第q季度 www HH:mm:ss:SSS'); => 2016-09-02 第3季度 星期五 13:19:15:792
+     *  formatDate(new Date(), 'yyyy-MM-dd 第q季度 星期w HH:mm:ss:SSS'); => 2016-09-02 第3季度 星期五 13:19:15:792
      *  formatDate(1472793615764); => 2016-09-02 13:20:15
      */
     const formatDate: (date?: Date | number | string, format?: string) => string;

package/lib/date/DateUtil.js

@@ -75,7 +75,7 @@ var DateUtil;
     dateFormatRules.forEach(function (item) {
       for (var index = 0, rules = item.rules, len = rules.length; index < len; index++) {
         rule = rules[index];
-        sIndex = format.indexOf("".concat(rule[0]));
+        sIndex = format.replaceAll('D', 'd').replaceAll('Y', 'y').indexOf("".concat(rule[0]));
         if (sIndex !== -1) {
           dates.push(parseFloat(dateStr.substring(sIndex, sIndex + Number(rule[1]))) + (item.offset || 0));
           // 如果匹配到规则中的第一条，则退出
@@ -91,13 +91,13 @@ var DateUtil;
   /**
    * 将日期格式化成指定格式的字符串
    * @param {Date | Number | String} date 要格式化的日期，不传时默认当前时间，也可以是一个时间戳/字符串
-   * @param {String} format 目标字符串格式，支持的字符有：y,M,d,q,w,H,h,m,S，默认：yyyy-MM-dd HH:mm:ss
+   * @param {String} format 目标字符串格式，支持的字符有：y,Y,M,d,D,q,w,H,h,m,S，默认：yyyy-MM-dd HH:mm:ss
    * @returns {String} 返回格式化后的日期字符串，日期不合法时返回字符串 'invalid date'
    * @example
    *  formatDate(); => 2016-09-02 13:17:13
    *  formatDate('2016-09-02','yyyy年MM月dd日'); => 2016年09月02日
    *  formatDate(new Date(), 'yyyy-MM-dd'); => 2016-09-02
-   *  formatDate(new Date(), 'yyyy-MM-dd 第q季度 www HH:mm:ss:SSS'); => 2016-09-02 第3季度 星期五 13:19:15:792
+   *  formatDate(new Date(), 'yyyy-MM-dd 第q季度 星期w HH:mm:ss:SSS'); => 2016-09-02 第3季度 星期五 13:19:15:792
    *  formatDate(1472793615764); => 2016-09-02 13:20:15
    */
   DateUtil.formatDate = function (date, format) {
@@ -118,35 +118,38 @@ var DateUtil;
       return 'invalid date';
     }
     date = date;
-    var obj = {
+    var map = {
       y: date.getFullYear(),
+      Y: date.getFullYear(),
       M: date.getMonth() + 1,
       d: date.getDate(),
+      D: date.getDate(),
       q: Math.floor((date.getMonth() + 3) / 3),
-      w: date.getDay(),
+      w: ['日', '一', '二', '三', '四', '五', '六'][date.getDay()],
       H: date.getHours(),
       h: date.getHours() % 12 === 0 ? 12 : date.getHours() % 12,
       m: date.getMinutes(),
-      s: date.getSeconds(),
-      S: date.getMilliseconds() // 毫秒
+      S: date.getMilliseconds(),
+      s: date.getSeconds()
     };
-    var week = ['天', '一', '二', '三', '四', '五', '六'];
-    var _loop_1 = function _loop_1(i) {
-      format = format.replace(new RegExp(i + '+', 'g'), function (m) {
-        var val = "".concat(obj[i]);
-        if (i === 'w') {
-          return (m.length > 2 ? '星期' : '周') + week[Number(val)];
-        }
-        for (var j = 0, len = val.length; j < m.length - len; j++) {
-          val = '0' + val;
-        }
-        return m.length === 1 ? val : val.substring(val.length - m.length);
-      });
+    var formatNumber = function formatNumber(n) {
+      return n.toString().padStart(2, '0');
     };
-    for (var i in obj) {
-      _loop_1(i);
-    }
-    return format;
+    var formatMilliseconds = function formatMilliseconds(n) {
+      return n.toString().padStart(3, '0');
+    };
+    return format.replace(/(y+|Y+|M+|d+|D+|q+|w+|H+|h+|m+|s+|S+)/g, function (match) {
+      var char = match[0];
+      var result = map[char];
+      if (char.toLowerCase() === 'y') {
+        result = result.toString().substr(4 - match.length);
+      } else if (char === 'S') {
+        result = formatMilliseconds(result);
+      } else if (['M', 'd', 'D', 'H', 'h', 'm', 's'].includes(char)) {
+        result = formatNumber(result);
+      }
+      return result;
+    });
   };
   /**
    * 将一个日期格式化成友好格式，比如，1分钟以内的返回“刚刚”，

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tools-min-ns",
   "description": "工具包适用于前端以及node",
-  "version": "1.13.0",
+  "version": "1.14.1",
   "main": "lib/index.js",
   "license": "MIT",
   "author": "nanshen",