tools-min-ns 1.5.2

package/esm/cookie/CookieUtil.d.ts

@@ -0,0 +1,56 @@
+type CookieAttributes = {
+    /**
+     * 定义删除cookie的时间。值可以是数字,将被解释为从创建时间开始的天数,或者是一个Date实例。如果省略,cookie将变为session cookie。
+     */
+    expires?: number | Date | undefined;
+    /**
+     * 定义cookie可访问的路径。默认值为'/'。
+     */
+    path?: string | undefined;
+    /**
+     * 定义 cookie 可访问的域名。默认值为创建 cookie 的页面所在域名
+     */
+    domain?: string | undefined;
+    /**
+     * 一个布尔值,表示是否需要使用安全的传输协议(https)来发送 cookie。默认为 false
+     */
+    secure?: boolean | undefined;
+    /**
+     * 断定一个cookie不能和跨域请求一起发送,这可以在一定程度上防止跨站请求伪造(CSRF)攻击
+     */
+    sameSite?: 'strict' | 'Strict' | 'lax' | 'Lax' | 'none' | 'None' | undefined;
+    [property: string]: any;
+};
+type CookiesStatic = {
+    readonly attributes: CookieAttributes;
+    readonly converter: Required<Converter<string>>;
+    set(name: string, value: string, options?: CookieAttributes): string | undefined;
+    get(name: string): string | undefined;
+    get(): {
+        [key: string]: string;
+    };
+    remove(name: string, options?: CookieAttributes): void;
+    withAttributes(attributes: CookieAttributes): CookiesStatic;
+    withConverter<TConv = string>(converter: Converter<TConv>): CookiesStatic;
+};
+type Converter<TConv> = {
+    write?: CookieWriteConverter<TConv> | undefined;
+    read?: CookieReadConverter<TConv> | undefined;
+};
+type CookieWriteConverter<T> = (value: string | T, name: string) => string;
+type CookieReadConverter<T> = (value: string, name: string) => string | T;
+declare namespace CookieUtil {
+    const set: (name: string, value: string, options?: CookieAttributes | undefined) => string | undefined;
+    const get: {
+        (name: string): string | undefined;
+        (): {
+            [key: string]: string;
+        };
+    };
+    const remove: (name: string, options?: CookieAttributes | undefined) => void;
+    const withAttributes: (attributes: CookieAttributes) => CookiesStatic;
+    const withConverter: <TConv = string>(converter: Converter<TConv>) => CookiesStatic;
+    const attributes: CookieAttributes;
+    const converter: Required<Converter<string>>;
+}
+export default CookieUtil;

package/esm/cookie/CookieUtil.js

@@ -0,0 +1,12 @@
+import api from './cookie';
+var CookieUtil;
+(function (CookieUtil) {
+  CookieUtil.set = api.set;
+  CookieUtil.get = api.get;
+  CookieUtil.remove = api.remove;
+  CookieUtil.withAttributes = api.withAttributes;
+  CookieUtil.withConverter = api.withConverter;
+  CookieUtil.attributes = api.attributes;
+  CookieUtil.converter = api.converter;
+})(CookieUtil || (CookieUtil = {}));
+export default CookieUtil;

package/esm/cookie/cookie.d.ts

@@ -0,0 +1,2 @@
+declare const _default: any;
+export default _default;

package/esm/cookie/cookie.js

@@ -0,0 +1,104 @@
+function init(converter, defaultAttributes) {
+  function set(name, value, attributes) {
+    var _a;
+    if (typeof document === 'undefined') {
+      return;
+    }
+    attributes = assign({}, defaultAttributes, attributes);
+    if (typeof attributes.expires === 'number') {
+      attributes.expires = new Date(Date.now() + attributes.expires * 864e5);
+    }
+    if (attributes.expires) {
+      attributes.expires = attributes.expires.toUTCString();
+    }
+    name = encodeURIComponent(name).replace(/%(2[346B]|5E|60|7C)/g, decodeURIComponent).replace(/[()]/g, escape);
+    var stringifiedAttributes = '';
+    for (var attributeName in attributes) {
+      if (!attributes[attributeName]) {
+        continue;
+      }
+      stringifiedAttributes += '; ' + attributeName;
+      if (attributes[attributeName] === true) {
+        continue;
+      }
+      // Considers RFC 6265 section 5.2:
+      // ...
+      // 3.  If the remaining unparsed-attributes contains a %x3B (";")
+      //     character:
+      // Consume the characters of the unparsed-attributes up to,
+      // not including, the first %x3B (";") character.
+      // ...
+      stringifiedAttributes += '=' + attributes[attributeName].split(';')[0];
+    }
+    return document.cookie = name + '=' + ((_a = converter.write) === null || _a === void 0 ? void 0 : _a.call(converter, value, name)) + stringifiedAttributes;
+  }
+  function get(name) {
+    var _a;
+    if (typeof document === 'undefined' || arguments.length && !name) {
+      return;
+    }
+    // To prevent the for loop in the first place assign an empty array
+    // in case there are no cookies at all.
+    var cookies = document.cookie ? document.cookie.split('; ') : [];
+    var jar = {};
+    for (var i = 0; i < cookies.length; i++) {
+      var parts = cookies[i].split('=');
+      var value = parts.slice(1).join('=');
+      try {
+        var found = decodeURIComponent(parts[0]);
+        if (!(found in jar)) jar[found] = (_a = converter.read) === null || _a === void 0 ? void 0 : _a.call(converter, value, found);
+        if (name === found) {
+          break;
+        }
+      } catch (e) {
+        // Do nothing...
+      }
+    }
+    return name ? jar[name] : jar;
+  }
+  return Object.create({
+    set: set,
+    get: get,
+    remove: function remove(name, attributes) {
+      set(name, '', assign({}, attributes, {
+        expires: -1
+      }));
+    },
+    withAttributes: function withAttributes(attributes) {
+      return init(this.converter, assign({}, this.attributes, attributes));
+    },
+    withConverter: function withConverter(converter) {
+      return init(assign({}, this.converter, converter), this.attributes);
+    }
+  }, {
+    attributes: {
+      value: Object.freeze(defaultAttributes)
+    },
+    converter: {
+      value: Object.freeze(converter)
+    }
+  });
+}
+var defaultConverter = {
+  read: function read(value) {
+    if (value[0] === '"') {
+      value = value.slice(1, -1);
+    }
+    return value.replace(/(%[\dA-F]{2})+/gi, decodeURIComponent);
+  },
+  write: function write(value) {
+    return encodeURIComponent(value).replace(/%(2[346BF]|3[AC-F]|40|5[BDE]|60|7[BCD])/g, decodeURIComponent);
+  }
+};
+export default init(defaultConverter, {
+  path: '/'
+});
+function assign(target) {
+  for (var i = 1; i < arguments.length; i++) {
+    var source = arguments[i];
+    for (var key in source) {
+      target[key] = source[key];
+    }
+  }
+  return target;
+}

package/esm/date/DateUtil.d.ts

@@ -0,0 +1,261 @@
+export type IDateDiff = {
+    year?: number;
+    month?: number;
+    week?: number;
+    day?: number;
+    hour?: number;
+    minute?: number;
+    second?: number;
+    millsecond?: number;
+};
+export type DiffDirection = 'BEFORE' | 'AFTER';
+export type TimeDimension = 'YEAR' | 'MONTH' | 'WEEK' | 'DATE' | 'HOUR' | 'MINUTE' | 'SECOND';
+export type IDatePart = {
+    Year: number;
+    Month: number;
+    Date: number;
+    Day: number;
+    Hour: number;
+    Minute: number;
+    Second: number;
+    Millsecond: number;
+};
+declare namespace DateUtil {
+    /**
+     * 将 字符串/时间戳 解析成日期对象
+     * @param {Date | String | Number} date 输入的日期字符串，如'2014-09-13',或者时间戳
+     * @param {String} format 字符串格式，默认'yyyy-MM-dd'，支持如下：y、M、d、H、m、s、S
+     * @returns {Date} 解析后的Date对象
+     *
+     * @example
+     *  parseDate('2018-11-26'); => new Date(2018, 10, 26)
+     *  parseDate('11/26/2018', 'MM/dd/yyyy') => new Date(2018, 10, 26)
+     *  parseDate('2018-11-26 13:28:43', 'yyyy-MM-dd HH:mm:ss') => new Date(2018, 10, 26, 13, 28, 43)
+     *  parseDate('2018年11月26日', 'yyyy年MM月dd日') => new Date(2018, 10, 26)
+     *  parseDate('2018年11月26日 11时40分', 'yyyy年MM月dd日 HH时mm分') => new Date(2018, 10, 26, 11, 40)
+     */
+    const parseDate: (date: Date | string | number, format?: string) => Date;
+    /**
+     * 将日期格式化成指定格式的字符串
+     * @param {Date | Number | String} date 要格式化的日期，不传时默认当前时间，也可以是一个时间戳/字符串
+     * @param {String} format 目标字符串格式，支持的字符有：y,M,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(1472793615764); => 2016-09-02 13:20:15
+     */
+    const formatDate: (date?: Date | number | string, format?: string) => string;
+    /**
+     * 将一个日期格式化成友好格式，比如，1分钟以内的返回“刚刚”，
+     * 当天的返回时分，当年的返回月日，否则，返回年月日
+     * @param {Date | number | string} date 如: new Date('2017-11-11')
+     * @returns {string} 解析后的友好化日期格式
+     * @example
+     * formatDateToFriendly() => 刚刚
+     */
+    const formatDateToFriendly: (date?: Date | number | string) => string;
+    /**
+     * 将一个日期格式化成友好格式，比如，当天返回时间，昨天返回 昨天 xx:xx ，本周返回 周x xx:xx 本年 xx月xx日 xx:xx 不是本年 xx年xx月xx日 xx:xx，
+     * @param {Date | number | string} date 如: new Date('2017-11-11')
+     * @returns {string} 解析后的友好化日期格式
+     * @example
+     * formatDateToFriendly2() => 2017年11月11日
+     */
+    function formatDateToFriendly2(date?: Date | number | string): string;
+    /**
+     * 判断是否为本周
+     * @param date
+     * @returns
+     */
+    function isCurrentWeek(date?: Date | number): boolean;
+    /**
+     * 获取日期对应的时间戳
+     * @param {Date | String} date 日期对象/日期字符串
+     * @param {String} format 字符串模板(date参数为字符串时有效)
+     * @returns {Number} 时间戳(单位:毫秒) 如果date参数不合法，则返回-1
+     * @example
+     * timestamp() => 1610625880136
+     */
+    const timestamp: (date?: Date | string, format?: string) => number;
+    /**
+     * 计算指定日期往前推指定时间
+     * @param {Date | string | number} date 初始日期，支持 Date 对象、日期字符串(需配合format参数)、时间戳
+     * @param {IDateDiff} diff 日期差值，支持年、月、日、周、时、分、秒、毫秒
+     * @param {string} format 日期格式字符串
+     * @example
+     * dateBefore(new Date(),{year:1}) => Tue Jan 14 2020 20:21:26 GMT+0800 (中国标准时间)
+     */
+    const dateBefore: (date: Date | string | number, diff: IDateDiff, format?: string) => Date;
+    /**
+     * 计算指定日期往后推指定时间
+     * @param {Date | string | number} date 初始日期，支持 Date 对象、日期字符串(需配合format参数)、时间戳
+     * @param {IDateDiff} diff 日期差值，支持年、月、日、周、时、分、秒、毫秒
+     * @param {string} format 日期格式字符串
+     * @example
+     * dateAfter(new Date(),{year:1}) => Tue Jan 14 2022 20:21:26 GMT+0800 (中国标准时间)
+     */
+    const dateAfter: (date: Date | string | number, diff: IDateDiff, format?: string) => Date;
+    /**
+     * 判断是否为闰年
+     * @param {Number} year 年份
+     *
+     * @example
+     *   isLeapYear(1900) = false
+     *   isLeapYear(2000) = true
+     *   isLeapYear(2001) = false
+     *   isLeapYear(2004) = true
+     */
+    const isLeapYear: (year: number) => boolean;
+    /**
+     * 计算在给定的年份中，给定的月份有多少天(会自动判断是否为闰年)
+     * @param {Number} year 年份
+     * @param {Number} month 月份 (0-11)
+     * @example
+     * getDaysInMonth(2012,2) => 31
+     */
+    const getDaysInMonth: (year: number, month: number) => number;
+    /**
+     * 获取时间的开头
+     * @param date 日期
+     * @param mode 时间维度 可以使用 Year Month Day Week Hour Minute Second
+     * @param format 字符串模板
+     * @example
+     * getDateStart(new Date(),'YEAR') => Fri Jan 01 2021 00:00:00 GMT+0800 (中国标准时间)
+     */
+    const getDateStart: (date: Date | string | number, mode: TimeDimension, format?: string) => Date;
+    /**
+     * 获取时间的结尾
+     * @param date 日期
+     * @param mode 时间维度 可以使用 Year Month Date Week Hour Minute Second
+     * @param format 字符串模板
+     * @example
+     * getDateEnd(new Date(),TimeDimension.Year) => Fri Dec 31 2021 23:59:59 GMT+0800 (中国标准时间)
+     */
+    const getDateEnd: (date: Date | string | number, mode: TimeDimension, format?: string) => Date;
+    /**
+     * 获取给定日期所在当年有多少天
+     * @param {Date | String | Number} date 日期
+     * @param {String} format 字符串模板
+     *
+     * @example
+     *  getDayOfYear('2018-11-26') => 365
+     *  getDayOfYear('12/20/2019', 'MM/dd/yyyy') => 365
+     *  getDayOfYear('2020-12-20') => 366
+     */
+    const getDayCountOfYear: (date: Date | string | number, format?: string) => number;
+    /**
+     * 获取给定日期在当年的第几天
+     * @param {Date | String | Number} date 日期
+     * @param {String} format 字符串模板
+     *
+     * @example
+     *  getDayIndexOfYear('2017-01-20') => 20
+     *  getDayIndexOfYear('2018-05-20') => 140
+     */
+    const getDayIndexOfYear: (date: Date | string | number, format?: string) => number;
+    /**
+     * 获取给定日期在当年的第几周
+     * @param {Date | String | Number} date 日期
+     * @param {String} format 字符串模板
+     *
+     * @example
+     *  getWeekIndexOfYear('2017-01-20') => 3
+     *  getWeekIndexOfYear('2018-05-20') => 20
+     */
+    const getWeekIndexOfYear: (date: Date | string | number, format?: string) => number;
+    /**
+     * 获取给定日期在当月的第几周
+     * @param {Date | String | Number} date 日期
+     * @param {String} format 字符串模板
+     *
+     * @example
+     *  getWeekIndexOfMonth('2017-01-20') => 3
+     *  getWeekIndexOfMonth('2018-05-20') => 3
+     */
+    const getWeekIndexOfMonth: (date: Date | string | number, format?: string) => number;
+    interface ITimeSpan {
+        Day: number;
+        Hour: number;
+        Minute: number;
+        Second: number;
+        Millsecond: number;
+    }
+    /**
+     * 计算两个日期的差
+     * @param date1 日期1
+     * @param date2 日期2
+     * @param format 字符串模板
+     * @example
+     * getDateDiff('2020-12-12','2021-10-12') => {Day: 304, Hour: 0, Minute: 0, Second: 0, Millsecond: 0}
+     */
+    const getDateDiff: (date1: Date | string | number, date2: Date | string | number, format?: string) => ITimeSpan;
+    /**
+     * 判断给定日期时间是否在某日期时间之前（默认当前日期时间）
+     * @param {Date | String | Number} date1 日期时间
+     * @param {Date | String | Number} date2 日期时间（默认当前日期时间）
+     * @param {String} format 字符串模板
+     *
+     * @example
+     *  isTimeBefore('2017-01-20') => true
+     *  isTimeBefore('2018-05-20') => true
+     */
+    const isTimeBefore: (date1: Date | string, date2?: Date | string, format?: string) => boolean;
+    /**
+     * 判断给定日期时间是否在某日期时间之后（默认当前日期时间）
+     * @param {Date | String | Number} date1 日期时间
+     * @param {Date | String | Number} date2 日期时间（默认当前日期时间）
+     * @param {String} format 字符串模板
+     *
+     * @example
+     *  isTimeAfter('2017-01-20') => false
+     *  isTimeAfter('2018-05-20') => false
+     */
+    const isTimeAfter: (date1: Date | string, date2?: Date | string, format?: string) => boolean;
+    /**
+     * 判断给定日期时间是否在时间段内（默认当前日期时间）
+     * @param { beginTime: Date | string; endTime: Date | string; time?: Date | string } options
+     * @param {String} format 字符串模板
+     *
+     * @example
+     *  const options = {beginTime:'2019-01-01',endTime:'2022-01-01',time:'2021-12-12'}
+     *  isTimeExist(options) => true
+     */
+    const isTimeExist: (options: {
+        beginTime: Date | string;
+        endTime: Date | string;
+        time?: string | Date | undefined;
+    }, format?: string) => boolean;
+    /**
+     * 补全日期区间数组
+     * @param {string} day1 '2022-01-01'
+     * @param {string} day2 '2022-01-03'
+     * @param {string} outFormat "yyyy-MM-dd" 输出的格式
+     * @returns ['2022-01-01','2022-01-02','2022-01-03']
+     */
+    function getSectionDateList(day1: string, day2: string, outFormat?: string): string[];
+    /**
+     * 补全月份区间数组
+     * @param {string} day1 '2022-01'
+     * @param {string} day2 '2022-03'
+     * @param {string} outFormat "yyyy-MM" 输出的格式
+     * @returns ['2022-01','2022-02','2022-03']
+     */
+    const getSectionMonthList: (day1: string, day2: string, outFormat?: string) => string[];
+    /**
+     * 补全年份区间数组
+     * @param {string} day1 '2022'
+     * @param {string} day2 '2024'
+     * @returns ['2022','2023','2024']
+     */
+    const getSectionYearList: (day1: string, day2: string) => string[];
+    /**
+     * 后端给的时间修复
+     * @param t
+     * @returns
+     */
+    const timeFix: (t?: string) => string | undefined;
+}
+export default DateUtil;