utiller 1.0.396 → 1.0.397

package/lib/utiller/index.js

@@ -4597,6 +4597,86 @@ var Utiller = /*#__PURE__*/function () {
       });
       return array;
     }
+
+    /**
+     * 將時間字串解析為物件，回傳 {startDate, startTime, endDate, endTime}
+     *
+     * 支援格式：
+     * 1. '2025/11/10 (一)｜13:00-15:00'
+     *    => { startDate:'2025/11/10', startTime:'13:00', endDate:'2025/11/10', endTime:'15:00' }
+     *
+     * 2. '2025/11/10 (一) 13:00 - 2025/11/12 (三) 15:00'
+     *    => { startDate:'2025/11/10', startTime:'13:00', endDate:'2025/11/12', endTime:'15:00' }
+     *
+     * @param {string} input - 欲解析的時間字串
+     * @returns {{startDate: string, startTime: string, endDate: string, endTime: string}} 解析後的時間物件
+     *
+     * @example
+     * getObjectOfStartEndDateTime('2025/11/10 (一)｜13:00-15:00');
+     * // => { startDate:'2025/11/10', startTime:'13:00', endDate:'2025/11/10', endTime:'15:00' }
+     *
+     * @example
+     * getObjectOfStartEndDateTime('2025/11/10 (一) 13:00 - 2025/11/12 (三) 15:00');
+     * // => { startDate:'2025/11/10', startTime:'13:00', endDate:'2025/11/12', endTime:'15:00' }
+     */
+  }, {
+    key: "getObjectOfStartEndDateTime",
+    value: function getObjectOfStartEndDateTime(input) {
+      if (!input || typeof input !== "string") {
+        return {
+          startDate: "",
+          startTime: "",
+          endDate: "",
+          endTime: ""
+        };
+      }
+
+      // 將全形符號與多餘空白轉換為標準形式
+      var cleaned = input.replace(/｜/g, " ").replace(/－/g, "-") // 全形破折號轉半形
+      .replace(/\s+/g, " ").trim();
+
+      // 跨日期格式 (例：2025/11/10 13:00 - 2025/11/12 15:00)
+      var crossDatePattern = /(\d{4}\/\d{1,2}\/\d{1,2})(?:\s*\([^)]*\))?\s*(\d{2}:\d{2})\s*-\s*(\d{4}\/\d{1,2}\/\d{1,2})(?:\s*\([^)]*\))?\s*(\d{2}:\d{2})/;
+
+      // 同日期格式 (例：2025/11/10 13:00 - 15:00)
+      var sameDatePattern = /(\d{4}\/\d{1,2}\/\d{1,2})(?:\s*\([^)]*\))?\s*(\d{2}:\d{2})\s*-\s*(\d{2}:\d{2})/;
+      var startDate, startTime, endDate, endTime;
+      if (crossDatePattern.test(cleaned)) {
+        var _cleaned$match = cleaned.match(crossDatePattern);
+        var _cleaned$match2 = (0, _slicedToArray2["default"])(_cleaned$match, 5);
+        startDate = _cleaned$match2[1];
+        startTime = _cleaned$match2[2];
+        endDate = _cleaned$match2[3];
+        endTime = _cleaned$match2[4];
+      } else if (sameDatePattern.test(cleaned)) {
+        var _cleaned$match3 = cleaned.match(sameDatePattern);
+        var _cleaned$match4 = (0, _slicedToArray2["default"])(_cleaned$match3, 4);
+        startDate = _cleaned$match4[1];
+        startTime = _cleaned$match4[2];
+        endTime = _cleaned$match4[3];
+        endDate = startDate;
+      } else {
+        return {
+          startDate: "",
+          startTime: "",
+          endDate: "",
+          endTime: ""
+        };
+      }
+
+      // 將日期時間轉為可比較的 Date 物件
+      var start = new Date("".concat(startDate, " ").concat(startTime));
+      var end = new Date("".concat(endDate, " ").concat(endTime));
+      if (end < start) {
+        throw new Error("End time cannot be earlier than start time: ".concat(input));
+      }
+      return {
+        startDate: startDate,
+        startTime: startTime,
+        endDate: endDate,
+        endTime: endTime
+      };
+    }
   }, {
     key: "getFilteredHeraPeriods",
     value:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "utiller",
-  "version": "1.0.396",
+  "version": "1.0.397",
   "description": "",
   "main": "index.js",
   "scripts": {

package/template/sample.package.json

@@ -11,7 +11,7 @@
   "license": "ISC",
   "dependencies": {
     "configerer": "^1.0.23",
-    "utiller": "^1.0.395",
+    "utiller": "^1.0.396",
     "linepayer": "^1.0.15",
     "databazer": "^1.0.17",
     "lodash": "^4.17.20",