util-helpers 4.3.0 → 4.4.0

package/esm/safeDate.js

@@ -0,0 +1,40 @@
+import _construct from "@babel/runtime/helpers/construct";
+import isNil from './utils/type/isNil'; // TODO: 函数重载，类型参照 Date
+
+/**
+ * 创建一个 Date 实例，同 new Date() 。<br/><br/>主要是规避了 iphone 设备浏览器不支持部分格式（YYYY-MM-DD HH-mm 或 YYYY.MM.DD）。
+ *
+ * @static
+ * @alias module:Processor.safeDate
+ * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date|Date}
+ * @since 4.4.0
+ * @param {string|number|Date} [value] 日期时间字符串、毫秒数、日期对象
+ * @param {...number} args 月/日/时/分/秒/毫秒
+ * @returns {Date} Date 实例
+ * @example
+ * safeDate('2022-1-1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate('2022/1/1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate('2022.1.1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate('2022.1.1 11:11'); // Sat Jan 01 2022 11:11:00 GMT+0800 (中国标准时间)
+ * safeDate(99, 1); // Mon Feb 01 1999 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate(1646711233171); // Tue Mar 08 2022 11:47:13 GMT+0800 (中国标准时间)
+ *
+ */
+
+function safeDate(value) {
+  var safeValue = typeof value === 'string' ? value.replace(/[\\.-]/g, '/') : value;
+
+  for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+    args[_key - 1] = arguments[_key];
+  }
+
+  if (args && args.length > 0) {
+    // @ts-ignore
+    return _construct(Date, [safeValue].concat(args));
+  } // @ts-ignore
+
+
+  return isNil(safeValue) ? new Date() : new Date(safeValue);
+}
+
+export default safeDate;

package/lib/index.js

@@ -189,6 +189,12 @@ Object.defineProperty(exports, "normalizeString", {
     return _normalizeString["default"];
   }
 });
+Object.defineProperty(exports, "safeDate", {
+  enumerable: true,
+  get: function get() {
+    return _safeDate["default"];
+  }
+});
 Object.defineProperty(exports, "plus", {
   enumerable: true,
   get: function get() {
@@ -294,6 +300,8 @@ var _setDataURLPrefix = _interopRequireDefault(require("./setDataURLPrefix"));
 
 var _normalizeString = _interopRequireDefault(require("./normalizeString"));
 
+var _safeDate = _interopRequireDefault(require("./safeDate"));
+
 var _plus = _interopRequireDefault(require("./plus"));
 
 var _minus = _interopRequireDefault(require("./minus"));

package/lib/normalizeString.js

@@ -16,6 +16,7 @@ function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "d
  *
  * @static
  * @alias module:Processor.normalizeString
+ * @see 参考 {@link tttps://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#string_instances|String}
  * @since 4.3.0
  * @param {*} value 待处理的值
  * @returns {string} 规整化的值

package/lib/safeDate.js

@@ -0,0 +1,56 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+
+var _isNil = _interopRequireDefault(require("./utils/type/isNil"));
+
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
+
+function _construct(Parent, args, Class) { if (_isNativeReflectConstruct()) { _construct = Reflect.construct; } else { _construct = function _construct(Parent, args, Class) { var a = [null]; a.push.apply(a, args); var Constructor = Function.bind.apply(Parent, a); var instance = new Constructor(); if (Class) _setPrototypeOf(instance, Class.prototype); return instance; }; } return _construct.apply(null, arguments); }
+
+function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+
+function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf || function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
+
+// TODO: 函数重载，类型参照 Date
+
+/**
+ * 创建一个 Date 实例，同 new Date() 。<br/><br/>主要是规避了 iphone 设备浏览器不支持部分格式（YYYY-MM-DD HH-mm 或 YYYY.MM.DD）。
+ *
+ * @static
+ * @alias module:Processor.safeDate
+ * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date|Date}
+ * @since 4.4.0
+ * @param {string|number|Date} [value] 日期时间字符串、毫秒数、日期对象
+ * @param {...number} args 月/日/时/分/秒/毫秒
+ * @returns {Date} Date 实例
+ * @example
+ * safeDate('2022-1-1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate('2022/1/1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate('2022.1.1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate('2022.1.1 11:11'); // Sat Jan 01 2022 11:11:00 GMT+0800 (中国标准时间)
+ * safeDate(99, 1); // Mon Feb 01 1999 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate(1646711233171); // Tue Mar 08 2022 11:47:13 GMT+0800 (中国标准时间)
+ *
+ */
+function safeDate(value) {
+  var safeValue = typeof value === 'string' ? value.replace(/[\\.-]/g, '/') : value;
+
+  for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+    args[_key - 1] = arguments[_key];
+  }
+
+  if (args && args.length > 0) {
+    // @ts-ignore
+    return _construct(Date, [safeValue].concat(args));
+  } // @ts-ignore
+
+
+  return (0, _isNil["default"])(safeValue) ? new Date() : new Date(safeValue);
+}
+
+var _default = safeDate;
+exports["default"] = _default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "util-helpers",
-  "version": "4.3.0",
+  "version": "4.4.0",
   "description": "一个基于业务场景的工具方法库",
   "main": "lib/index.js",
   "module": "esm/index.js",

package/types/index.d.ts

@@ -29,6 +29,7 @@ export { default as blobToDataURL } from "./blobToDataURL";
 export { default as dataURLToBlob } from "./dataURLToBlob";
 export { default as setDataURLPrefix } from "./setDataURLPrefix";
 export { default as normalizeString } from "./normalizeString";
+export { default as safeDate } from "./safeDate";
 export { default as plus } from "./plus";
 export { default as minus } from "./minus";
 export { default as times } from "./times";

package/types/normalizeString.d.ts

@@ -4,6 +4,7 @@ export default normalizeString;
  *
  * @static
  * @alias module:Processor.normalizeString
+ * @see 参考 {@link tttps://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/String#string_instances|String}
  * @since 4.3.0
  * @param {*} value 待处理的值
  * @returns {string} 规整化的值

package/types/safeDate.d.ts

@@ -0,0 +1,21 @@
+export default safeDate;
+/**
+ * 创建一个 Date 实例，同 new Date() 。<br/><br/>主要是规避了 iphone 设备浏览器不支持部分格式（YYYY-MM-DD HH-mm 或 YYYY.MM.DD）。
+ *
+ * @static
+ * @alias module:Processor.safeDate
+ * @see 参考 {@link https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Date|Date}
+ * @since 4.4.0
+ * @param {string|number|Date} [value] 日期时间字符串、毫秒数、日期对象
+ * @param {...number} args 月/日/时/分/秒/毫秒
+ * @returns {Date} Date 实例
+ * @example
+ * safeDate('2022-1-1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate('2022/1/1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate('2022.1.1'); // Sat Jan 01 2022 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate('2022.1.1 11:11'); // Sat Jan 01 2022 11:11:00 GMT+0800 (中国标准时间)
+ * safeDate(99, 1); // Mon Feb 01 1999 00:00:00 GMT+0800 (中国标准时间)
+ * safeDate(1646711233171); // Tue Mar 08 2022 11:47:13 GMT+0800 (中国标准时间)
+ *
+ */
+declare function safeDate(value?: string | number | Date | undefined, ...args: number[]): Date;